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About This Manual 



This manual contains the formats, descriptions, and examples for the following 
commands: 

• Network operations 

• Network Performance Analyzer (NPA) 

• Dump Analyzer 

Audience 

This manual is written for the person performing Control Data Distributed 
Communications Network (CDCNET) activities, such as starting and stopping 
communication lines and displaying operational status of network components. 
Communication support analysts may use some of the commands described within 
during troubleshooting. Customer engineers may also use this manual for reference. 

The reader should have knowledge of CONTROL DATA® NOS/VE (Network Operating 
System/Virtual Environment) and/or NOS (Network Operating System) concepts and 
operations, as well as an understanding of CDCNET's general purposes and concepts, as 
described in the CDCNET Conceptual Overview. 
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Organization 

This manual documents CDCNET commands. 

Chapter 1 contains an introduction of the manual contents. 

Chapter 2 contains the network operations session control commands. 

Chapter 3 contains the network operations ADD commands. 

Chapter 4 contains the network operations CANCEL commands. 

Chapter 5 contains the network operations CHANGE commands. 

Chapter 6 contains the network operations DEFINE commands. 

Chapter 7 contains the network operations DELETE commands. 

Chapter 8 contains the network operations DISPLAY commands. 

Chapter 9 contains the network operations EXEET, HELP, IDLSD, IDLTS, and KIL 
commands. 

Chapter 10 contains the network operations LOAD and RESUME commands. 

Chapter 11 contains the network operations SENDD and SETDT commands. 

Chapter 12 contains the network operations START commands. 

Chapter 13 contains the network operations STOP commands. 

Chapter 14 contains the network operations SYNC, UNLF, UNLM, and WRITM 
commands. 

Chapter 15 contains the terminal definition/user procedure commands. 

Chapter 16 contains the load procedure commands. 

Chapter 17 contains the configuration file management commands. 

Chapter 18 contains the NPA commands. 

Chapter 19 contains the dump analyzer commands. 

The appendixes contain additional information about CDCNET commands. 

Appendix A contains a glossary of terms. 

Appendix B contains the CDCNET (NLTERM, NLLIST, and NLPURGE) utility 
commands. 

Appendix C contains the CDCNET file and procedure management (NETFM, 
NETBDF, NETMDF, and NETRDF) utilities. 

Appendix D contains the Manage CDCNET Configuration (MANCC) utility 
commands. 

Appendix E contains the Network Configuration Utility (NETCU). 
Appendix F contains the character set. 
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Appendix G contains the DI reset codes. 



Conventions 

The following conventions are used in this manual: 

• The terms CDCNET and network are used interchangeably. 

• Commands, parameters, or descriptive text that apply to only NOS or NOS/VE 
operating systems are marked either NOS only or NOS/VE only. 

• The NOS operating system recognizes only the abbreviated form of command names 
and parameters. 

• In general, all NPA commands on NOS/VE follow the standard System Command 
Language (SCL). See the NOS/VE Commands and Functions manual. 

• All NPA commands on NOS are CYBER Control Language (CCL) commands (except 
REFCLF) and follow the CCL syntax conventions (see the NOS Version 2.3 Screen 
Formatting Reference manual). 

• On NOS/VE, a blank (space) may be used in place of a comma (,). 

• All numbers are decimal unless otherwise specified. 

• A vertical bar in the margin indicates a technical change. 

• The following typographical conventions are used: 



boldface 



italics 



UPPERCASE 



example 



Command and subcommand names are shown in boldface type 
when illustrating a format. Required parameters are also in 
boldface. 

Optional parameters in a command or subcommand format are 
shown in italics. 

Uppercase indicates names of commands, subcommands, and 
parameters (and their abbreviations). Names of variables, files, 
and system constants are shown in uppercase when they occur 
in text. 

Examples, including user input, are printed in a typeface that 
simulates computer output. 



60000414 D 



About This Manual 9 



Terminal Use 

The terminal you use allows you to perform some procedures interactively in either 
screen mode or line mode, or both. 

If you have a video display terminal (VDT), you can choose to perform some procedures 
in either screen or line mode. If you do not have a VDT, you are limited to performing 
the procedures in line mode. 

Screen mode operation (NOS only) provides you with a full screen menu display of 
required and optional parameters. All you need to do is fill in the appropriate values 
on the corresponding lines of the menu display. 

Line mode operation allows you to enter the command and all the parameters at one 
time. 

Special Keyboard Entries 

CDCNET supports a variety of terminals. Although the individual keys used in our 
examples may not be present on your keyboard, your terminal contains keys that 
provide similar functions. 

See the CDCNET Terminal Interface manual for more information. 
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Related CDCNET Manuals 



Manual Abstracts 

Following is a brief description of each CDCNET manual. 



Conceptual Overview 



Product Descriptions 



Terminal Interface 



Access Guide 



TCP/IP Programming 
Interfaces and 
Applications 



Batch Device User Guide 



Discusses CDCNET in conceptual terms. It provides a broad 
view of CDCNET that explains the theoretical nature of 
this product. It does not attempt to define which particular 
product capabilities and features are currently available 
and which ones will follow in subsequent releases. 

Provides reference, planning, and training information for 
customers who own or are interested in owning CDCNET 
products, and for Control Data personnel who use or work 
on CDCNET. The manual describes hardware and software 
products, provides information on how to select and use 
various types of network cables, and provides network 
configuration examples. 

This is the primary manual for end-users who use 
interactive terminals to access computer services connected 
to CDCNET. The manual explains general terminal 
interface concepts, terminal commands and attributes, and 
connection attributes. For the advanced user, site 
administrator, and network analysts it also covers more 
advanced topics such as virtual and transparent modes, 
resolving communications problems, and the various 
terminal protocols supported by CDCNET. 

This online manual guides the novice user through the 
process of accessing and using computer services through 
CDCNET. It includes procedures for connecting, 
disconnecting, and managing connections; displaying and 
changing terminal attributes; and terminal user exception 
processing. The more experienced user can find additional 
related information in the CDCNET Terminal Interface 
manual. 

Describes how to access the utilities that implement the 
TCP/IP protocols through CDCNET. The manual assumes 
the user is familiar with CDCNET terminal and connection 
attributes; knows the service title to access; and has some 
working knowledge and understanding of TCP/IP protocols. 

Describes how to operate batch devices connected to 
CDCNET. It assumes the user is familiar with NOS and/or 
NOS/VE operating systems and with CDCNET access to 
these operating systems. The manual defines the concepts 
of I/O stations and provides the procedures for defining and 
controlling these stations. The online manual is available 
with NOS/VE and NOS operating systems. 
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Hardware Installation 
and Troubleshooting 



Configuration Guide 



DI Dump Analyzer 



Network Operations and 

Analysis 



Contains hardware installation procedures and 
troubleshooting guidelines for CDCNET hardware products 
and associated I/O cables. The manual is intended for 
individuals who install and check out CDCNET hardware 
products, operate them, add options to them, and maintain 
them. 

Documents how to configure CDCNET software after it is 
installed on an operating system, and describes the 
responsibilities of the CDCNET network administrator. This 
manual also documents the Manage CDCNET Configuration 
Utility (MANCC), a utility for creating and editing files 
defining a CDCNET network. 

This manual is an online version of the DI Dump Analyzer 
section of the CDCNET Network Operations and Analysis 
manual. The manual is for CDCNET analysts who are 
familiar with Control Data host computer operating system 
concepts and operations. The manual describes how to use 
information from the Analyze CDCNET Dump (ANACD) 
utility to help troubleshoot network problems. Available 
with NOS/VE only. 

This manual documents how to monitor, control, and 
reconfigure CDCNET using the CDCNET Network Operator 
Utility (NETOU). The Network Operations section walks an 
operator through operations concepts, basic and advanced 
operations activities, and elementary troubleshooting 
decisions. 

The Network Analysis section describes the tools and 
methods used to analyze CDCNET performance including: 
instructions for using the CDCNET DI Dump Analyzer, a 
list of DI reset codes, a map of fixed address memory, and 
definitions of important system data structures. 

The NPA section of the manual provides information on 
how to generate various types of NPA reports and provides 
examples and descriptions of all NPA reports. 
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Diagnostic Messages 



Commands 



CDCNET Network 
Management Station 



This manual is for network operators, network analysts, 
and programmers. The manual provides sorted lists of 
diagnostic messages and command responses issued by the 
CDCNET software. The primary sorted list of diagnostic 
messages describes the event causing each message and the 
appropriate user action. The primary sorted list of 
command responses describes the event causing the 
command response. Secondary sorted lists of diagnostic 
messages and command responses provide a cross reference 
of diagnostic message number and command response 
number to the CDCNET software products that issue the 
messages or command responses. 

The printed version of this manual is no longer available. 
However, a copy of the messages file can be printed on 
site. Available with both NOS/VE and NOS operating 
systems. 

This manual contains all of the CDCNET Operator/Analyst 
commands. This manual is intended for operators, systems 
analysts, support engineers, and other experienced users. 

This manual documents how to install, configure, and 
operate the CDCNET Network Management Station. The 
manual is for CDCNET operators and aministrators having 
previous experience as a UNIX system administrator. 



Manual History 

Not all sites find it convenient or expedient to install each new ve. sion and PSR level 
of CDCNET software. This presents a problem in maintaining sets of manuals that 
reflect installed software when later versions of CDCNET software are available but 
not installed. The following CDCNET Manual History table helps users to assemble 
and maintain the appropriate documentation by indicating which manual revisions 
support each release of CDCNET. 

Manual/Audience Matrix 

The CDCNET Manual/Audience matrix helps site planners, administrators, and users to 
determine their CDCNET documentation needs. The matrix categorizes each manual 
according to its type: overview, reference, tutorial, and so on. It then defines the 
audience of each manual in general terms: customer, end-user, LAN installer, and so 
on. Sites may have different audience designations for their audience, or may combine 
user functions. 



60000414 F 



About This Manual 13 
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Ordering Manuals 

Control Data manuals are available through Control Data Sales Offices or from: 

Control Data 

Literature and Distribution Services ARHLDS 

4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 

I You can also call (612)415-4478 or FAX your inquiry to (612)415-4359. 

Submitting Comments 

Control Data welcomes your comments about this manual. Your comments may include 
your opinion of the usefulness of this manual, your suggestions for specific improvements, 
and the reporting of any errors you have found. 

You can submit your comments on the comment sheet on the last page of this manual. If 
the comment sheet has already been used, you can mail your comments to: 

Control Data 

Documentation Services ARH219 
4201 Lexington Avenue N. 
St. Paul, MN 55126-6198 

You can also submit your comments through SOLVER, an on-line facility for reporting 
problems. To submit a documentation comment through SOLVER, do the following: 

1. Select Report a new problem or change in existing PSR from the main SOLVER menu. 

2. Respond to the prompts for site-specific information. 

3. Select Write a comment about a manual from the new menu. 

4. Respond to the prompts. 
Please indicate whether or not you would like a written response. 
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Customer Support Hotline 

Control Data maintains a hotline to assist you in the use of our products. This hotline 
service is available to you for each product you license and cover with a Control Data 
software support agreement. 

If you need help not provided by the documentation or find that a product does not perform 
as described, contact the hotline through one of the following methods: 



Mail 

Mailing Address 



Control Data 

AEH213 

4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 



Shipping Address 



Control Data 
Central Software Support 
4233 Lexington Avenue N. 
Arden Hills, MN 55126-6198 



Telephone 
Telephone Number 



800-345-6628 
612-415-4272 



Countries 



USA and Canada (follow touchtone prompts) 
Other countries 



Internet 
Internet Address 



epix@css.cdc.com 

irix@css.cdc.com 

eplx@css.cdc.com 

nos@css.cdc.com 

nosve@css.cdc.com 

networks@css.cdc.com 

compilers@css.cdc.com 

icem@css.cdc.com 

support@css.cdc.com 

solveradm@css.cdc.com 

solver@css.cdc.com 



Support Area 



EP/IX Operating System Support 

IRIX Operating System Support 

EP/LX Operating System Support 

NOS Operating System Support 

NOS/VE Operating System Support 

Network Support 

Compiler Support 

ICEM Support 

Miscellaneous 

SOLVER Validations 

Email interface to SOLVER 



60000414 H 



About This Manual 17 



When you call or write the support hotline, please include the following information: 

• Site Number (assigned for all hardware and software support requests) 

• Operating system and level installed 

• Machine type (for example, 4360-302, 910B-232) 

• Product for which support is needed 

• Details concerning the problem 

This allows CSS to solve your problem as quickly and efficiently as possible. 

SOLVER 

As a Control Data support customer, you also receive a subscription to SOLVER, the online 
support service. SOLVER is an interactive tool with menus and help for all functions and 
prompts. After some initial interactive setup, a subset of SOLVER functions is also 
available via email. Email in a prescribed format can be sent to solver@css.cdc.com for 
automatic processing. 

From SOLVER, you can report problems (PSRs) to Control Data, search with keywords to 
find similar problem reports from other sites, monitor progress against a PSR (including 
workarounds and fix availability), request software enhancements (RSEs), and write 
comments against the documentation. SOLVER also includes Installation Bulletins that 
document post-release highlights, warnings, and product update announcements. 

For help with SOLVER or SOLVER validation information, contact CSS at the telephone 
numbers listed above or email to solveradm@css.cdc.com. 
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Introduction 



This chapter gives an overview of the commands used to configure and analyze a 
network. This includes the commands for: 

• Network Operator Utility (NETOU) 

- Session Control 

- Network Operations 

• Terminal Definition Procedure (TDP) 

• Terminal User Procedure (TUP) 

• Load Procedure 

• Configuration File Management 

• Network Configuration Utility (NETCU) 

• Network Performance Analyzer (NPA) 

• DI Dump Analyzer 

Network Operator Utility (NETOU) Commands 

The Network Operator Utility (NETOU) allows you to access CDCNET and run 
network operations commands. These commands let you inspect and significantly alter 
the network. Use these commands to: 

• Monitor the status of network components. 

• Change the operational state of network components. 

• Manage network component failures. 

• Configure network components logically. 

Operations commands can be divided into the following types: 

• Session control commands which are used to define and control your operations 
environment and operations sessions, but do not control or change the network. 
Since there are different operations environments for CDCNET on NOS/VE and 
NOS, each operating system has its own set of session control commands and 
activities. 

• Network commands which are used to monitor, control, and dynamically change the 
logical definition of network equipment. 

You access NETOU to perform network operations activities from a remote terminal or 
from a host console on NOS. 

The command syntax is the same whether you are at an interactive terminal or host 
console. However, some aspects of terminal and console command entry, display and 
screen control are different. This chapter explains these differences. 
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Network Operator Utility (NETOU) Commands 



Starting a NETOU Session 



NOS/VE and NOS differ when it comes to starting a NETOU session. Assuming you 
are validated to use NETOU, you must first log onto the network host (NOS/VE or 
NOS) on which you have validation. 

S^SJ? 0S/VB ' NETC >U is a system command you can enter in response to the 
NOS/VE system prompt. See the CDCNET Network Operations and Analysis manual 
for descriptions of this command's optional PROLOG and STATUS parameters. 

S^ta 1 ! 08, y*** NET0U f0r the a PP licati °«; * you are already logged onto the 
NUS IAF application, use one of the following commands to begin a NETOU session: 

HELLO, NETOU 



or 



or 



BYE, NETOU 



APPSW, NETOU 

w#SSf faction between using NETOU on NOS/VE and NOS is that under 
NOS/VE, the host runs its own versions of some CDCNET software. This software 
enables the host to manage a NETOU session between you and the network. 

When using NETOU under NOS, you must establish a working relationship with a 
Mainframe Device Interface (MDI). This MDI, which you designate the Command MDI 
coordinates your session with the other CDCNET systems on the network. 

The SET_COMMAND_MDI Command (NOS only) 

After you specify NETOU as the application, you see the NETOU banner and the 
prompt to enter the SET_COMMAND_MDI (SETCM) command. A list of the available 
MDIs is provided with the prompt. 

The NETOU banner message and prompt are formatted as follows: 

WELCOME TO NETWORK OPERATOR UTILITY 
CDCNET - COPYRIGHT CONTROL DATA CORP, 1985, 1986. 1987, 1988. 

STATUS OF CONNECTED MDIs 
NODE CURRENT SYSTEM 
NUMBER STATE TITLE 

089 AVAILABLE MDI_8B 
088 AVAILABLE MTI_F 
093 AVAILABLE MDI.A 

More than one MDI available. 
To select a DI, type: SETCM MDI-MDINAME 
MDINAME is optional, if not specified, 
default is MDI.8B 

Lm£ re than 0ne MDI is available to ^ a s Command MDI, you must enter the 
SETCM command to begin the NETOU session. A default Command MDI is assigned if 
you enter the SETCM command without the MDI parameter. 
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If there is only one MDI available to act as Command MDI, that MDI is selected for 
you by default; the banner and prompt are formatted as follows: 

WELCOME TO NETWORK OPERATOR UTILITY 
CDCNET - COPYRIGHT CONTROL DATA CORP, 1985, 1986, 1987, 1988. 

STATUS OF CONNECTED MDIs 
NODE CURRENT SYSTEM 
NUMBER STATE TITLE 

089 AVAILABLE MDI.8B 

Only one MDI available, and Is automatically selected. 

When you are working from a NOS host, selecting the appropriate Command MDI can 
be important. Two different MDIs connected to a NOS host may provide access to 
networks that are not connected by CDCNET network solutions. These are called 
disjoint networks. 

If you are uncertain about whether different MDIs service disjoint networks, use 
SETCM for each, in turn, and compare the displays from the DISPLAY_CATENET_ 
TITLES (DISCT) command for each. If the system titles are different for the two 
displays, the networks served by the two MDIs are disjoint. Or, you can try to send 
any command to the system in question; if the command completes successfully, the 
two systems are on the same catenet. 

You can monitor disjoint networks simultaneously if you use the RETAIN parameter on 
the SETCM command. This parameter lets you retain your session with the current 
Command MDI when you create a new session with another MDI. Any operator alarms 
sent to either the retained or newly selected Command MDI are displayed immediately 
to the operator. To return to the previous session, reissue the SETCM command, 
naming the appropriate MDI. 

Some NETOU commands are executed directly by the MDI you designated as the 
Command MDI. Other commands (those that execute in a remote system or systems) 
require you to use the SEND_COMMAND (SENC) command. Commands enclosed in a 
SENC command are processed at the specified remote CDCNET system(s). 

NOTE 

For a more detailed description of NETOU, see the CDCNET Network Operations and 
Analysis manual. 



The SEND ..COMMAND Command 

The SENC command is used in NETOU on NOS/VE and NOS to package a NETOU 
command for delivery to a remote system or systems, where it is then executed. The 
format is as follows: 

SEND.COMMAND COMMAND- 'conmand_St ring' SYSTEM=(11st 1..15 of name) 

The command string to be executed by the remote system(s) must be enclosed in single 
quotes. 

The list of systems must be enclosed in parentheses (a single system name need not be 
enclosed in parentheses, however). Under NOS/VE, the SYSTEM parameter is required. 
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Under NOS, if you do not specify a system name or names, NETOU sends the 
command to the destination system(s) of the most recent SENC command. If you have 
not used the SENC command in the current NETOU session, NETOU sends the 
command to the Command MDI for execution. 

The NOS/VE version of SENC has two additional parameters: OUTPUT and STATUS. 
OUTPUT lets you write command output to a specified file (the NOS- only ROUTE _ 
COMMAND .RESPONSE (ROUCR) command effectively gives you the option of an 
alternative output file for your NOS-based NETOU session). STATUS is the standard 
NOS/VE status variable. 

NETOU accepts either the default system name or a valid alias when you are sending 
commands to CDCNET systems. For example, if MDI_8B is a registered title for $DI_ 
08002510008B, you could send a command to this DI with either of the following 
commands: 

SENC 'command_str1ng' $DI_08002510008B 

or 

SENC 'command.string' MDI.8B 

Entering Characters Not Supported at a NOS Host Console 

NETOU commands use a subset of the syntax for NOS/VE SCL commands. SCL uses 
the ASCII character set, which has characters the NOS host console (CC545 and 721) 
does not support. On the NOS host console, you must type two characters, or an escape 
sequence, to designate the ASCII characters not supported on the console. 

On the NOS host console screen, unsupported ASCII characters are designated by other 
characters. For a character which represents more than one ASCII character when 
displayed, such as the asterisk (*), the only way to know which ASCII character it 
represents is by the display's context. Table 1-1 shows escape sequences for 
unsupported ASCII characters and how these characters are represented on the console 
screen. 
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Table 1-1. NOS Host Console Escape Sequences and Displays 



Character 


Name 


Escape 
Sequence 
On Keyboard 


Displayed 

On Screen As: 


A 


Circumflex 


/l 


/l 


fl 


Quotation Marks 


/2 


11 


# 


Number Sign 


/3 


/3 


$ 


Dollar Sign 


/4 


/4 


@ 


Commercial At 


/5 


/5 


1 


Semicolon 


/6 


/6 


? 


Question Mark 


11 


11 


{ 


Opening Brace 


/8 


/8 


} 


Closing Brace 


/9 


/9 


_ 


Underline 


Hyphen (-) or /0 


- 


[ 


Opening Bracket 


/( 


A 


] 


Closing Bracket 


D 


/) 


> 


Greater Than 


/+ 


/+ 


< 


Less Than 


/= 


/= 


I 


Aposotrophe 


/* 


/* 


/ 


Slant 


II 


/ 


J 


Exclamation Point 


None 


• 


% 


Percent Sign 


None 


* 


& 


Ampersand 


None 


+ 


\ 


Reverse Slant 


None 


* 


* 


Grave Accent 


None 


* 


1 


Vertical Line 


None 


* 


- 


Tilde 


None 


* 


■ 


Colon 


/, 


• 


- 


Minus, Hyphen 


/- 


- 


a..z 


Lowercase 


IK.JZ 


A..Z 
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Terminal Definition Procedure (TDP) Commands 

TDP commands are used in Terminal Definition Procedures to define the characteristics 
of terminal/workstation types and/or models. TDP procedures are initially developed by 
Network Administrators and are a part of the DI configuration procedures that reside 
on CYBER hosts. 

TDPs execute separately from system configuration procedures, but they are referenced 
in commands in the system configuration procedures. Typically, TDPs are referenced by 
the DEFINE _LINE commands defining the communications lines connected to the DI. 

If you need more information on how to use TDPs, see the CDCNET Configuration 
Guide. 

Terminal User Procedure (TUP) Commands 

TUP commands are software procedures that end users write to modify the conventions 
specified in the TDP. With TUPs, you can save operating conventions on an ongoing 
basis. Alternatively, you can issue interactive commands to tailor your terminal 
conventions session-by-session. 

If you need more information on how to use TUPs, see the CDCNET Configuration 
Guide. 

Load Procedure Commands 

Load procedure commands define information to be downloaded to a batch device, such 
as a printer, or translate data to or from a device. Currently, CDCNET supports' the 
following types of load procedures: 

• Initializaton Procedures (D?s) 

• File Prefix Procedures (FPs) 

• Code Set Procedures 

• Vertical Format Unit (VFU) Load Procedures (VLPs) 

If you need more information on how to use load procedures, see the CDCNET 
Configuration Guide. 

Configuration File Management Commands 

These commands are used to access CDCNET configuration procedures such as TDP 
and TUP. If you need more information on how to use these procedures, see the 
CDCNET Configuration Guide. 

Exception File Commands 

Exception file commands specify the load process procedures for specific systems or the 
default entries, which specify the load process procedures, for systems that do not have 
an explicit system entry of their own. See the CDCNET Configuration Guide for more 
information on exception file commands. 
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Network Performance Analyzer (NPA) Commands 

NPA is a network analysis tool made up of flexible modular software components 
resident in your CONTROL DATA® CYBER 170 or CYBER 180 Computer System. NPA 
helps you analyze the performance of your network by producing a variety of reports. 
These reports allow you to: 

• Identify the configuration of your network 

• Identify actual and potential hardware and software failures 

• Identify potential congestion on communication lines 

• Determine if your network is performing correctly 

• Evaluate network use 

You may generate these reports individually to reflect a specific aspect of the network's 
performance, or you may generate a group of reports that reflect an overall picture of 
the network. You may also create reports that are tailor-made for your specific needs. 
The standard set of reports is described in the CDCNET Network Operations and 
Analysis manual. 

If you need more information on how to use NPA, see the CDCNET Network 
Operations and Analysis manual. 

DI Dump Analyzer Commands 

Under default operating conditions, a CDCNET DI dumps its memory to a host-resident 
file whenever it is forced to reset as the result of an error condition (refer to DI Reset 
Codes appendix for a complete list of reset codes). The Device Interface Dump Analyzer 
is a host-resident tool that reformats the information in DI dump files. 

Dump Analyzer subcommands let you display information about the conditions that 
existed at the time of the reset, including: 

• Important data structures 

• Contiguous memory 

• Program call chains 

• Task control information 

If you need more information on how to use the Dump Analyzer, see the CDCNET 
Network Operations and Analysis manual. 
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ACTIVATE .ALARMS (ACTA) 2-2 

CHANGE .ALARM .ENVIRONMENT (CHAAE) (NOS Only) 2-3 

DEACTIVATE .ALARMS (DEAA) 2-4 

DISPLAY.ALARM .ENVIRONMENT (DISAE) (NOS Only) 2-5 

DISPLAY.ALARM .HISTORY (DISAH) (NOS Only) 2-6 

DISPLAY.CATENET.TITLES (DISCT) (NOS Only) 2-7 

DISPLAY.COMMAND .INFORMATION (DISCI) (NOS Only) 2-9 

DISPLAY.COMMAND.LIST (DISCL) 2-11 

DISPLAY.COMMAND .LIST.ENTRY (DISCLE) 2-13 

DISPLAY.CONNECTED _MDI (DISCM) (NOS Only) 2-14 

EXECUTE .COMMAND .FILE (EXECF) (NOS Only) 2-15 

HELP (NOS Only) 2-17 

INCLUDE.FILE (INCF) (NOS Only) 2-18 

QUIT (QUI) 2-20 

RESTORE .ALARM .ENVIRONMENT (RESAE) (NOS Only) 2-21 

ROUTE.ALARM (ROUA) (NOS Only) 2-22 

ROUTE .COMMAND .RESPONSE (ROUCR) (NOS Only) 2-23 

SEND .COMMAND (SENC) 2-24 

SEND .COMMAND .SEQUENCE (SENCS) (NOS Only) 2-25 

SET.COMMAND.MDI (SETCM) (NOS Only) 2-27 

** Command (NOS Only) 2-29 
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This chapter provides complete descriptions of all session control commands for both 
NOS/VE and NOS-based network operations environments. Command descriptions are 
organized alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operational environments. 

NOTE 

Session control commands are not contained within a SEND_COMMAND. 
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ACTTVATE^ALARMS (ACTA.) 



ACTIVATE _ALARMS (ACTA) 
NETOU Command 



Purpose 



Format 



Parameters 



Responses 
Remarks 



Initiates receipt of alarms from DIs. This command must be entered after 
invoking NETOU to allow alarms to be reported to you. 

ACTIVATE ..ALARMS 

GROUPS = list of name 

OUTPUT = file 

STATUS = status variable (NOS/VE only) 

GROUPS or GROUP (G) 

Specifies the names of the alarm groups for which alarms are to be 
collected. Default is CATENET. In this release of CDCNET, CATENET is 
the only value accepted for this parameter. 

OUTPUT (O) 

Specifies the file to receive the alarm messages. Default is $OUTPUT. 

STATUS (NOS/VE only) 

See basic status concepts for NOS/VE System Command Language in the 
NOS/VE System Usage manual. 

—ERROR- Alarms already active. 

To ensure that alarms are activated each time you log in to NOS/VE and 
access NETOU, include this command in your NETOU prolog. 



Examples NOU/act 1 vate_a 1 arms 



NOU/ 
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CHANGE _ALARM_ENV1R0NMENT (CHAAE) (NOS Only) 



CHANGE _ALARM ^ENVIRONMENT (CHAAE) (NOS Only) 
NETOU Command 

Purpose Changes the list of DIs from which you receive alarms. You may shut off 

or again turn on the receipt of alarms from DIs. Use of this command does 
not affect alarms received by other network operators, if your network has 
more than one network operator. 

If you disable receipt of alarms from a specific system, then you receive no 
alarms from that system, regardless of the communities to which the 
system belongs. If you disable receipt of alarms from a specific community, 
however, you may receive alarms from any system that belongs to both the 
disabled community and some other community not disabled. Disabling 
alarms by system takes precedence over disabling alarms by community. 

Format CHANGE .ALARM .ENVIRONMENT 

DISABLE _SYSTEM = list 1..15 of name 
ENABLE ^SYSTEM = list 1..15 of name 
DISABLE JCOMMUNITY = list 1..15 of name 
ENABLE JCOMMUNITY = list 1. .15 of name 

Parameters DISABLE jSY STEM (DS) 

Name or names of DI or DIs for which receipt of alarms by the network 
operator is to be shut off. Entry of a name already disabled is permitted. 

ENABLE jSYSTEM (ES) 

Name or names of DI or DIs for which receipt of alarms by the network 
operator is to be turned back on. Entry of a name already enabled is 
permitted. 

DISABLE JCOMMUNITY (DC) 

The community title or titles from which receipt of alarms is to be 
disabled. Entry of a title already disabled is permitted. Currently, the only 
allowed value for this parameter is CATENET, which specifies all the DIs 
in the catenet. 

ENABLE JCOMMUNITY (EC) 

The community title or titles from which receipt of alarms is to be 
enabled. Entry of a title already enabled is permitted. Currently, the only 
allowed value for this parameter is CATENET, which specifies all the DIs 
in the catenet. 

Responses Alarm environment updated. 

-ERROR— Community <name> is not in the operator's domain of control. 

-ERROR— System <name> is not in the operator's domain of control. 
Examples change_alarm_env1ronment ds=eng1n_bld_td1 

Alarm environment updated. 
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DEACTIVATE_ALARMS (DEAA) 



DEACTIVATE .ALARMS (DEAA) 
NETOU Command 

Purpose Terminates receipt of alarms from CDCNET DIs. 

Format DEACTIVATE .ALARMS 

STATUS = status variable (NOS/VE only) 

Parameters STATUS (NOS/VE only) 

See basic status concepts for NOS/VE System Command Language in the 
NOS/VE System Usage manual. 

Responses Alarms deactivated. 

-ERROR- Alarms not active. 
Examples deacti vat e_al arms 

NOU/ 
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DISPLAY_ALARM ..ENVIRONMENT (DISAE) (NOS Only) 
NETOU Command 

Purpose Displays the list of DI communities with your operations domain of control 
from which receipt of alarms is enabled or disabled. This command also 
lists the DIs from which alarms are disabled. Currently, the only 
community that is displayed is CATENET, and the only domain of control 
supported is the catenet. 

Format DISPLAY_ALARM _ENVIRONMENT 

Parameters None. 

Responses Alarm Environment. 
(See example.) 

Examples d 1 sp 1 ay_a 1 ar m_en v 1 r onmen t 

Alarm Environment 

Community Alarm Status 

CATENET Enabled 

Disabled Systems 
-None- 
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DISPLAY_ALARM ..HISTORY (DISAH) (NOS Only) 
NETOU Command 

Purpose Displays alarms received at your operations station since the start of your 
command session, in chronological order. The limit for the display list is 
50 display lines. If you receive more than 50 display lines, then new 
display lines replace the oldest alarms on the display. (Because there is a 
blank line between each alarm, you may see only 34 nonblank lines of 
text.) '■'*"*' 

Format DISPLAY_ALARM .HISTORY 

DISPLAY JOPTION = keyword value 

Parameters DISPLAY JOPTION (DO) 

Specifies how many alarms are displayed. 



Responses 



Examples 



Keyword Value 

LAST 

PAGE 
ALL 

Default is LAST. 



Description 



Displays all alarms received since the last DISAH 
command was entered. 

Displays last page of alarms received. 

Displays all alarms that are in the buffer, which 
has a limited buffer size. 



ALARM HISTORY REPORT 

(Followed by a list of alarms. See example.) 

No new alarms received since last DISPLAY_ALARM_HISTORY. 
d1splay_alarm_hi story 

ALARM HISTORY REPORT 



•••*•* ALARM FROM MTI_83 85/10/10 13.38.51 

—ERROR-- Line: LINE31 down, connection timer expired 

•••••• ALARM FROM MTI_83 85/10/10 13.38.55 

—ERROR— Line: LINE23 down, auto-recognition failed 

• ALARM FROM MTI_83 85/10/10 13.40.28 

—ERROR— Line: LINE23 down, auto-recognition failed 



619 



202 



202 



2-6 CDCNET Commands 



60000414 C 
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DISPLAY_CATENET_TITLES (DISCT) (NOS Only) 
NETOU Command 

Purpose Displays the system, community, and internal and external titles in the 

catenet that are registered through the Directory Management Entity (ME). 

Format DISPLAY_CATENET JTITLES 

DISPLAY JOPTION = list of keyword value 

Parameters DISPLAY JOPTION (DO) 

Specifies what type (one or more) of titles to display. The following 
keyword values are allowed. 



Keyword Value 



Description 



SYSTEM (S) 



COMMUNITY (C) 



INTERNAL .SERVICE 
(IS) 



EXTERNAL .SERVICE 
(ES) 



ALL 



Displays titles of all CDCNET systems (DIs) 
known in the CDCNET network. Searches the 
entire catenet for the titles. 

Displays titles of DI communities. The only 
supported value is CATENET. 

Displays titles of services that are known only 
to network services and the command MDI. 
Displays only the contents of the command 
MDI/MTI directory. Internal titles are internal 
to CDCNET and are not visible to network 
users. 

Displays titles of services that are known to 
external users. The titles are known only to the 
command MDI. Displays only the contents of the 
command MDI/MTI directory. External titles are 
available or visible to all the network operators 
and network users. 

Displays system, community, internal service, 
and external service titles. 



Default is SYSTEM. 
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DISPLAY_CATENET_TITLES (DISCT) (NOS Only) 



Responses Catenet Titles 

(Followed by the titles display. See examples). 

If a specified type is not registered through the Directory ME, the 
following response is inserted in the display: 

None were found. 

Examples d1splay_catenet_t1tles 

Catenet Titles 
community titles 
CATENET 



system titles 

NORTH_ENGIN_BLD_TDI 

ENGINEER_CYBER_MDI 

ADMIN_BLD_TDI_2 

HDQTRS_BLD_TDI_1 

HDQTRS_CYBER_MDI 

lnternal_serv1ce titles 
ENGINEERING 

external .service titles 
NP_GW_ENGINEERING 



SOUTH_ENGIN_BLD_TDI 

ADMIN_BLD_TDI_1 

ADMIN_BLD_NDI_TRUNK 

HDQTRS_BLD_TDI_2 

ENG_HDQTRS_NDI_TRUNK 



HDQTRS 



NP_GW_HDQTRS 
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DISPLAY_C0MMAND_INF0RMATION (DISCI) (NOS Only) 



DISPLAY_COMMAND .INFORMATION (DISCI) (NOS Only) 
NETOU Command 

Purpose Displays parameters and parameter syntax information for a specified 
session command. The specified command must be one of the available 
session commands. 

NOTE 

On NOS/VE, this is a standard system command. 

Format DISPLAY.COMMAND .INFORMATION 

COMMAND = name 

Parameters COMMAND (C) 

Specifies the command for which the parameters are to be displayed. You 
must provide either the full command name or the command abbreviation. 
The specified command must be one of the following session commands. 

ACTIVATE .ALARMS 

BYE 

CHANGE .ALARM .ENVIRONMENT 

DEACTIVATE .ALARMS 

DISPLAY.ALARM .ENVIRONMENT 

DISPLAY.ALARM .HISTORY 

DISPLAY.CATENET.TITLES 

DISPLAY.COMMAND .INFORMATION 

DISPLAY-COMMAND .LIST 

DISPLAY.COMMAND .LIST.ENTRY 

DISPLAY.CONNECTED _MDI 

EXECUTE .COMMAND .FILE 

GOODBYE 

HELLO 

HELP 

INCLUDE JFILE 

LOGIN 

LOGOUT 

QUIT 

RESTORE .ALARM .ENVmONMENT 

ROUTE .ALARM 

ROUTE .COMMAND .RESPONSE 

SEND .COMMAND 

SEND .COMMAND .SEQUENCE 

SET.COMMAND _MDI 
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DISPLAY_COMMAND JNFORMATION (DISCI) (NOS Only) 



Responses List of parameter names, parameter abbreviations, and parameter syntax 
for the specified command. (See example.) 

-ERROR- Parameter COMMAND is required but was omitted. 

-ERROR- The following parameter value, < string > is not a valid 
command name. 



Remarks 



The DISPLAY_COMMAND JNFORMATION session command is similar to 
the network command of the same name, with two important differences: 

• The session command displays only the session commands available to 
the operator. 

• The session command is not embedded within the SEND_COMMAND 
network command. 



Examples display_command_1nformat1on cornnand=1nclude_f1 le 



flle.fname = $required 
username, unname = $optional 



2-10 CDCNET Commands 



60000414 C 



DISPLAYJ30MMAND JJST (DISCL) 

DISPLAY_COMMAND_LIST (DISCL) 
NETOU Command 

Purpose On NOS, this command displays the list of session control commands for 
which you are validated. 

On NOS/VE, this command returns the system command list established 
for the operator. This list includes the NETWORK, OPERATOR .UTILITY. 

Format DISPLAY_COMMAND _LIST 

Parameters None. 

Responses NOS/VE, system commands list. 

NOS, alphabetical list of NETOU commands (see example). 
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DISPLAY.COMMAND JUST (DISCL) 

Examples The following example shows a response generated by NOS NETOU. 
d 1 sp 1 ay_command_ 1 1 st 

act 1 vat e_al arms 

bye 

change.a 1 arm_en v 1 ronment 

deact1vate_alarms 

d 1 sp 1 ay_a 1 arm_env 1 ronment 

d1splay_alarm_history 

d 1 sp 1 ay_cat enet _t 1 1 1 es 

dl splay_command_information 

d 1 sp 1 ay_command_ 1 1 st 

d 1 sp 1 ay_command_ 1 1 st _ent r y 

d 1 sp 1 ay_connect ed_md 1 

execute_coranand_f 1 le 

goodbye 

hello 

help 

1nclude_f1le 

login 

logout 

quit 

restore_alarm_envi ronment 

rout e_al arm 

route_command_response 

send_command 

send_command_sequence 

set_command_md1 

** command to exit SENCS mode 

* escape character in SENCS mode 
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DISPLAY_COMMANDJJST_ENTRY (DISCLE) 

DISPLAY_COMMAND JLIST_ENTRY (DISCLE) 
NETOU Command 

Purpose On NOS, this command displays the list of session control commands for 
which you are validated. This command is an alias for the DISPLAY.. 
COMMAND _LIST command. 

On NOS/VE, this command returns the list of session control commands. 

Format DISPLAY_COMMAND _LIST_ENTRY 

Parameters None. 

Responses NOS/VE, list of session control commands (see example). 

NOS, alphabetical list of session control commands. 
Examples The following example shows a NOS/VE command list, 
d i sp 1 ay_command_ I i st _ent ry 

act 1 vate.al arms deact i vate.a 1 arms 

quit send_command 
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DISPLAY_CONNECTED_MDI (DISCM) (NOS Only) 



DISPLAY_CONNECTED_MDI (DISCM) (NOS Only) 
NETOU Command 

Purpose Displays the coupler numbers, system titles, and operational status of the 
MDIs and MTIs that are physically connected to the host mainframe. 

On NOS, you can only control the network (by sending commands and 
receiving responses through NETOU) through the MDI which you have 
selected for communication with the network. This command is executed 
automatically during the login process. This display contains one line for 
each MDI or MTI connected to the host. 

Format DISPLAY_CONNECTED _MDI 

Parameters None. 

Remarks MDIs may have the following operational states. 



Responses 



Examples 



SELECTED 
ACTIVE 

AVAILABLE 
UNAVAILABLE 



You are currently communicating with this MDI. 

MDI has been selected previously, and connection has 
been retained. 

MDI is available for selection. 

MDI is not available for selection. This state indicates 
that the MDI has started to establish communication 
with NETOU but it is not yet ready to allow operator 
sessions to be established. The system title is not 
known at this time. If the MDI remains in this state, 
the MDI is probably hung. 



STATUS OF CONNECTED MDIs 
(See example.) 

No path to CDCNET available. 

d i sp 1 ay_connect edjnd 1 

STATUS OF CONNECTED MDIs 
NODE CURRENT SYSTEM 
NUMBER STATE TITLE 



3 


SELECTED 


MTI_83 


5 


ACTIVE 


MDI_84 


6 


AVAILABLE 


MDI.8A 


7 


UNAVAILABLE 


—UNKNOWN 
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EXECUTE_COMMAND_FILE (EXECP) (NOS Only) 



EXECUTE .COMMAND .FILE (EXECF) (NOS Only) 
NETOU Command 



Purpose 



Directs NETOU to read the named file in your catalog. The INCLUDE. 
FILE command is an alias for this command. The file may contain any 
network operations commands, except the EXECUTE .COMMAND JFILE, 
INCLUDE _FILE, and SET_COMMAND_MDI commands. 

For example, you may construct a file that contains commands to select 
the alarm messages for you. The file's contents are interpreted as one or 
more commands. These commands may be any operator environment or 
network commands that address systems or communities within your 
domain of control. 

NOTE 

On NOS/VE, use the standard system command INCLUDE _FILE. 



Format 



Parameters 



Remarks 



EXECUTE .COMMAND .FILE 
FILE = name 

USERJNAME - name 

FILE (F) 

Specifies the name of the file in your catalog or in the catalog of the 
alternate user name, specified by the USER_NAME parameter ..(described 
next). The file name follows the NOS rules for file names. The file must 
be an indirect access permanent file, residing on the default family. 

USER_NAME (UN) 

Specifies the user name of an alternate catalog in which the command file 
is located. If the command file is in any catalog other than your own, you 
must specify this parameter. 

File contents can be in display code if you do not use characters that are 
not supported in display code, such as * and @. If you do use nondisplay 
code characters, file contents must use the ASCII 6/12 character code set. 
Enter the NOS ASCII command prior to creating command files to ensure 
this; otherwise, use the NOS FCOPY command to change the command 
file's character code set from another set to the ASCII 6/12 character code 
set. Reading of the file is terminated at the first end-of-record (EOR) or 
end-of-file (EOF) encountered. 

If you are going to access the command file from another user name with 
the USER_NAME parameter, the file must be public, semiprivate, or 
private with read access permitted to you. 

Secondary user statements executed within IAF have no effect. The default 
user name reverts back to the original login user name. 

You may stop execution of the file by entering a user break 1 or 2 
sequence. 
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EXECUTE_COMMAND_PILE (BXECP) (NOS Only) 



If a command inside the command file aborts or causes an error, execution 
of the command file ceases. For example, if a ROUTE .COMMAND _ 
RESPONSE command in a command file gets a PFM error, execution of 
the command file ceases. 

Responses Command file <file_name> executing. 

(This response is then followed by the responses to the commands in the 
file (unless responses are routed to a file.) 

Last command in command file is incomplete and is discarded. 

-ERROR- EXECUTE _COMMAND_FILE or INCLUDE .FILE command 
format error, < file .name > not specified. 

-ERROR- Command file <file_name> not found under username <un>. 

-ERROR- EXECUTE .COMMAND.FILE command is not valid in 
command file. Processing of command file is terminated. 

-ERROR- SET_COMMAND_MDI command is not valid in command file 
Processing of command file is terminated. 

-ERROR- File <file_name> is a direct access file, should be indirect 
access. 

Examples The following command directs a file of statistics control commands called 
NETSTAT to be read and executed: 

execute_command_f11e f11e=netstat 

Command file NETSTAT executing 



(This section contains responses to the 
commands in NETSTAT.) 
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HELP (NOS Only) 
NETOU Command 

Purpose Displays a list of CDCNET network commands for which you are validated. 

The commands are arranged in alphabetical order. Only the long form of 
the command is returned. 

NOTE 

On NOS/VE, HELP is a standard system command. 

Format HELP 

Parameters None. 

Responses Displays an alphabetical list of network operator's commands (see example). 

Examples help 

act i vat e_al arms 

bye 

change_alarm_envi ronment 

deact i vat e„a 1 arms 

display_alarm_envi ronment 

d 1 sp 1 ay_a 1 arm_h i st or y 

d1splay_catenet_titles 

dl splay_command_inf ormat 1on 

d 1 sp 1 ay _comman d_ list 

diplay_command_l 1st_entry 

d 1 sp 1 ay_connec t ed_md 1 

execute_command_f 1 le 

goodbye 

hello 

help 

1nclude_f11e 

login 

logout 

quit 

restore_alarm_env1 ronment 

route.alarm 

route_command_response 

send_command 

send_command_sequence 

set _command_md 1 

** command to exit SENCS mode 

* escape character In SENCS mode 
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INCLUDE _FILE (INCF) (NOS Only) 
NETOU Command 



Purpose 



Format 



Parameters 



Remarks 



Directs NETOU to read the named file in your catalog. This command is 
an alias for the EXECUTE _COMMAND_FILE command. The file may 
contain any network operations commands, except the EXECUTE. 
COMMAND_FILE, INCLUDE JPILE, and SET_COMMAND_MDI 
commands. 

For example, you may construct a file that contains commands to select 
the alarm messages for you. The file's contents are interpreted as one or 
more commands. These commands may be any operator environment or 
network commands that address systems or communities within your 
domain of control. 



NOTE 



On NOS/VE, INCF is a standard system command. 



INCLUDE _FILE 
FILE = name 

USER_NAME = name 

FILE (F) 

Specifies the name of the file in your catalog or in the catalog of the 
alternate user name, specified by the USER_NAME parameter (described 
next). The file name follows the NOS rules for file names. The file must 
be an indirect access permanent file, residing on the default family. 

USER_fiTAME (UN) 

Specifies the user name of an alternate catalog in which the INCLUDE. 
FILE is located. If the INCLUDE _FILE is in any other catalog than your 
own, you must specify this parameter. 

File contents can be in display code if you do not use characters that are 
not supported in display code, such as * and @. If you do use nondisplay 
code characters, file contents must use the ASCII 6/12 character code set. 
Enter the NOS ASCII command prior to creating command files to ensure 
this; otherwise, use the NOS FCOPY command to change the command 
file's character code set from another set to the ASCII 6/12 character code 
set. Reading of the file terminates at the first end-of-reeord (EOR) or 
end-of-file (EOF) encountered. 

If you are going to access the command file from another user name with 
the USER_NAME parameter, the file must be public, semiprivate, or 
private with read access permitted to you. 

Secondary user statements executed within IAF have no effect. The default 
user name reverts back to the original login user name. 

You may stop execution of the file by entering a user break 1 or 2 
sequence. 
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INCLUDE _FILE (INCF) (NOS Only) 



If a command inside the INCLUDE _FILE aborts or causes an error, 
execution of the INCLUDE _FILE ceases. For example, if a ROUTE _ 
COMMAND_RESPONSE command in an INCLUDE _FILE gets a PFM 
error, execution of the INCLUDE _FILE ceases. 

Responses Command file <file_name> executing. 

(This response is then followed by the responses to the commands in the 
file, unless responses are routed to a file). 

Last command in command file is incomplete and is discarded. 

-ERROR- INCLUDE _FILE command format error, <file_name> not 
specified. 

-ERROR— Command file <file_name> not found under username <user_ 
name>. 

-ERROR- INCLUDE _FILE command is not valid in command file. 
Processing of command file is terminated. 

-ERROR- SET_COMMAND_MDI command is not valid in command file. 
Processing of command file is terminated. 

-ERROR— File <file_name> is a direct access file, should be indirect 
access. 

Examples The following command directs a file of statistics control commands called 
NETSTAT to be read and executed. 



include_f11e f11e=netstat 
Command file NETSTAT executing 

File NETSTAT complete 



(This section contains responses to the 
commands in NETSTAT.) 
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QUIT (QUI) 
NETOU Command 

Purpose Terminates the Network Operator Utility (NETOU) session. After the 
QUIT command executes, NETOU commands are not valid during a 
command entry session. 

Format QUIT 

Parameters None. 

Examples quit 

Remarks The following NOS-only session control commands perform the same 
function and are used in the same way as the QUIT command. 

BYE 

GOODBYE 

HELLO 

LOGIN 

LOGOUT 
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RESTORE _ALARM .ENVIRONMENT (RESAE) (NOS Only) 
NETOU Command 

Purpose Restores a changed alarm environment to the environment that was 

defined at operator session login. Reenables receipt of alarms from DIs by 
a network operator. Reenables disabled alarm communities. 

Format RESTORE _ALARM .ENVIRONMENT 

Parameters None. 

Responses Alarm environment restored. 

Remarks Use this command after your alarm environment has been changed by the 
CHANGE _ALARM .ENVIRONMENT or DEACTIVATE .ALARMS 
command to return to the original set of DIs that report alarms to you. 

Examples rest ore_a 1 arm_env1 ronment 
Alarm environment restored. 
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ROUTE .ALARM (ROUA) (NOS Only) 
NETOU Command 

Purpose Routes all alarms to a specified direct access file. If you enter this 

command at the start of your operations session, all alarms that follow are 
routed to a file. At the start of an operations session, routing to the 
operations console display is assumed. 

If a direct access file to receive alarms already exists, subsequent alarms 
are appended to the end of the file. If the file does not exist, NETOU 
defines the file. If the file is busy, or the named file is an indirect access 
permanent file, the command fails. Both command responses and alarms 
may be routed to the same file. 

Format ROUTE .ALARM 

FILE = list 1.2 of name and/or DISPLAY 

Parameters FILE (F) 

The name of the file to receive the alarms. The alarm file is a text file 
that uses the ASCII 6/12 character code set. This file must be a NOS 
direct access permanent file. You may define the same file to receive both 
alarms and command responses. If the file does not exist, NETOU defines 
the file. If the file already exists, NETOU appends subsequent alarms to 
the end of the existing file. 

The keyword DISPLAY indicates that you want alarms to be returned to 
your terminal or console screen. Both a file name and DISPLAY may be 
entered as a list in parentheses. In that case, alarms are both recorded in 
the file and returned to your display. If you specify a file name and 
DISPLAY, only one file name may be specified. The file name follows the 
NOS rules for file names. If you specify no file name, the default DISPLAY 
is assumed, and alarms are returned to your terminal or console screen. 

Responses Alarms routed to <file_name>. 

Alarms routed to DISPLAY and <file_name>. 

-ERROR- Illegal ROUTE command, when more than one file is specified 
one must be DISPLAY. 

-ERROR- Illegal ROUTE command, DISPLAY specified more than once. 

-ERROR- File <file_name> is an indirect access file, should be direct 
access. 

Entering a second ROUTE _ALARM command terminates the alarm 
routing from a previous command. 

This example shows the ROUTE _ALARM command establishing that 
alarms are to be routed to both a direct access file called TODLOG and to 
the operations station display. 

route.alarm fl le=(todlog, display) 
Alarms routed to DISPLAY and TODLOG. 



Remarks 



Examples 
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ROUTE ^COMMAND ..RESPONSE (ROUCR) (NOS Only) 
NETOU Command 

Purpose Routes all command responses to a specified direct access file. This 

command is used only in NOS-based CDCNET operations. If you enter this 
command at the start of your operations session, or make it part of your 
operator's user prolog, all command responses that follow are routed to a 
file. This command allows you to review lengthy responses, such as status 
and configuration displays, using a listing of the responses. 

Format ROUTE .COMMAND .RESPONSE 

FILE = list 1.2 of name or DISPLAY 

Parameters FILE (F) 

The name of the file to receive the responses. This file must be a NOS 
direct access permanent file. Note that both command responses and 
alarms may be routed to the same file. A command response file is a NOS 
direct access text file that uses the ASCII 6/12 character code set. 

If the file does not exist, NETOU defines the file. If the file already exists, 
NETOU appends subsequent command responses to the end of the file. If 
the file name specified is DISPLAY, responses are routed to your 
operations station. At the start of an operations session, routing to 
DISPLAY is assumed. If you specify a file name and DISPLAY, only one 
file name may be specified. If you specify no file name, the default 
DISPLAY is assumed. 

Responses Command responses routed to <file_name>. 

Command responses routed to DISPLAY and <file_name>. 

-ERROR- Illegal ROUTE command, when more than one file is specified, 
one must be DISPLAY. 

-ERROR- Illegal ROUTE command, DISPLAY specified more than once. 

-ERROR- File <file_name> is an indirect access file, should be direct 
access. 

Remarks Entering a second ROUTE .COMMAND .RESPONSE command terminates 
the command response routing from a previous command. 

Examples This example shows the ROUTE .COMMAND .RESPONSE command 

establishing that command responses are to be routed to both direct access 
file TODLOG and to the operations station display. This example and the 
ROUTE .ALARM command example show messages being routed to the 
same file (TODLOG). 

route_command_response f 1 le=(todlog;d1splay) 
Command responses routed to DISPLAY and TODLOG. 
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SEND ...COMMAND (SENC) 
NETOU Command 

Purpose Sends a CDCNET command to a DI or list of DIs. 
Format NOS Only 

SEND_COMMAND 

COMMAND = string 
SYSTEM = list 1..15 of name 

NOS/VE Only 

SEND .COMMAND 

COMMAND = string 
SYSTEM = list of name 

OUTPUT = file name 
STATUS = status _variable 

Parameters COMMAND (C) 

The network operations command to be sent to the specified DI. Enter the 
command as a string value enclosed by apostrophes 0). You may use the 
abbreviated form of the command. If the command you are sending 
contains a string value (such as WRITE .TERMINAL JVIESSAGE), you 
must use two consecutive apostrophes at the beginning and end of the 
string in order for the enclosed string to be recognized (see examples). You 
cannot substitute the quotation mark character for two apostrophes. 

SYSTEM (S) (NOS/VE only) 

The logical or physical DI name or list of DI names to which the command 
is to be sent. If a CDCNET command is sent to more than one CDCNET 
system, a response must be received from each system for the command to 
complete. If no response is received in 2 minutes, a timer terminates the 
command. 

SYSTEM (S) 

The logical or physical DI name or list of DI names to which the command 
is to be sent. If you omit this parameter, the name of the last DI or list of 
DIs to which you sent a command is used. The default DI for the first use 
of SEND.COMMAND during your session is the MDI through which you 
are connected to the network. 

OUTPUT (O) (NOS/VE only) 

The file to which a normal command response is written. Default value is 
$OUTPUT. 

STATUS (NOS/VE only) 

See basic status concepts for NOS/VE System Command Language in the 
NOS/VE System Usage manual. 

Examples senc c*'d1shs',s=md183 

sencLcommand c='wr1te_term1nal_message, . . 
m«*"Englneerlng""s network will be down until 10:00'" 
s-tdll 
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SEND .COMMAND .SEQUENCE (SENCS) (NOS Only) 
NETOU Command 

Purpose Allows you to send one or more commands to the same system(s) without 
enveloping the command within a SENC command. This command puts you 
in a special type of command entry mode (SENCS mode). You receive a 
prompt after entering the SENCS command: /SENCS. All commands you 
enter following the prompt are sent only to those systems specified in the 
system parameter of the command. As you enter each command, the 
command is sent to the specified system(s) for processing. 

NOTE 

When you are within SENCS mode, READY., is the prompt at a K- display 
system console. SENCS/ is the prompt at an operator console. 



The SENCS command may be included in a prolog or command file. If so, 
all subsequent commands are sent directly to the system specified by the 
command. 



Format 



Parameters 



To leave the SENCS mode, you enter **. If a prolog or command file 
contains the SENCS command, all subsequent commands on that file are 
sent to the specified system for processing until a ** is detected. 

If you want to send a network command to other systems while in the 
SENCS mode, use an escape character (a single asterisk *). To use the 
escape character, type the escape character * followed by the network 
command on the same line. This one command is then sent to the specified 
systems and need not be encapsulated within the SENC command. 
Subsequent commands are again processed in the SENCS mode unless they 
are preceded with the escape character. When a command is continued on 
more than one line, the * applies only to the first line. In other words, if * 
is entered anywhere in the subsequent lines, it is treated as part of the 
command text. 

SEND .COMMAND .SEQUENCE 
SYSTEM = list 1..15 of name 

SYSTEM (S) 

Specifies the logical or physical DI name or list of DI names to which the 
command is to be sent. A maximum of 15 system titles may be specified. 
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SEND_C0MMANDJ5EQUENCE (SENCS) (NOS Only) 

Responses Entering SENCS mode, type ** to exit. 

-ERROR- Parameter SYSTEM is required but was omitted. 

Examples The following command sends a DISPLAY_DI .SYSTEM _STATUS 
command to the DI named North _TDI_1. 

send_command_sequence system ■ north_td1_1 

SENCS/d1splay_d1_system_status 

SENCS/*' 

The following command sends a DISPLAY_DI .SYSTEM _STATUS 
command to DIs North _TDI_1 and East_TDI_2. 

send_command_sequence system»(north_td1_1 ,east_td1_2) 

SENCS/d 1 sp 1 ay_d 1 _syst em_st at us 

SENCS/** 
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SET.COMMAND JMDI (SETCM) (NOS Only) 
NETOU Command 

Purpose Selects the MDI (or MTI) through which you send commands to the 
network and from which you receive responses and alarms from the 
network. At any time, you can communicate with only one MDI. If only 
one DI (MDI or MTI) is connected to a host, this command is not needed. 
It is only needed in configurations supporting more than one MDI or MTI 
per host. When you select an MDI for the first time, your user prolog 
automatically executes. Subsequent, consecutive selection of the same MDI 
causes recovery of the operator environment for that MDI. Using this 
command, you may switch communications from one MDI to another. 
Whenever you select a different MDI, the session with the currently 
selected MDI is broken. You may specify whether or not the operations 
session should be terminated with the old MDI (using the RETAIN 
parameter). 

You receive responses only from the currently selected MDI. However, you 
receive alarms from all MDIs with which you have active NETOU sessions. 
If a session with a previously selected MDI is retained (see RETAIN 
parameter) and the previously selected and currently selected MDI are in 
the same catenet, you receive the same alarm twice, once from each MDI. 
Because of this, the RETAIN parameter should only be used when 
switching between MDIs belonging to disjoint catenets. 

Format SET .COMMAND _MDI 

MDI = name 
RETAIN = boolean 

Parameters MDI (M) 

The system name of the MDI or MTI to which your operations session is 
switched. If you omit this parameter, NETOU attempts to use the MDI 
specified on the NETOU job statement as the default MDI to be selected, if 
an MDI is specified and it is available. Otherwise, NETOU selects the 
longest- connected available MDI as the default. 

RETAIN (R) 

Indicates whether or not the operations session with the currently selected 
MDI or MTI should be retained. Possible values are YES, Y, NO, or N. If 
you select YES, the current session is retained. You may subsequently 
resume that session using another SET .COMMAND _MDI command. If you 
select NO, the operations session with the MDI or MTI you have been 
using is ended. If you are switching between MDIs or MTIs on disjoint 
catenets, RETAIN should be set to YES. NETOU displays received alarms 
for both the retained session and your currently selected session at your 
operations session as well as sending them to the alarm history buffer. 
You may also review the alarms for a retained session using the 
DISPLAY_ALARM .HISTORY command. If you are switching between 
MDIs or MTIs on a common catenet, RETAIN should be set to NO. This 
prevents NETOU from displaying duplicate alarms for the new and 
previous sessions. Default is NO. 
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Responses MDI selected = < system _title> 

-ERROR- The value < value > is not valid as a RETAIN option. 

-ERROR- MDI not available, MDI = < system _name>. 

Remarks This command cannot be contained in a CDCNET network operations 
command file. 

Examples set_command_md1 mdl=md1_3 

MDI selected = MDI.3 
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** Command (NOS Only) 

** Command (NOS Only) 
NETOU Command 

Purpose Terminates the SEND _COMMAND .SEQUENCE execution mode. 

Format ** 

Parameters None. 

Remarks Use this command when in SENCS mode. The command allows you to exit 
(quit) the SENCS mode of execution begun when you entered the SENCS 
command earlier in your session. 

Examples SENCS/** 
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ADD_ARP_REPORTED_NETS (ADDARN) 3-2 

ADD.CLNS .FILTER (ADDCF) 3-2.2 

ADD_CONS_INCALL (ADDCI) 3-4 

ADD_CONS_OUTCALL (ADDCO) 3-4.2 
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This chapter provides complete descriptions of all CDCNET Network Operations ADD 
commands. Command descriptions are organized alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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ADD_ARP_REPORTED_NETS (ADDARN) 
DI Configuration Procedure/NETOU Command 



Purpose 



Format 



Parameters 



Responses 



Informs Address Resolution Protocol (ARP) when the DI configured with 
this command responds to ARP requests for IP networks accessible by this 
DI. ADDARN applies only in a multi-LAN IP network environment. 
ADDARN switches ARP from a mode in which a DI responds to ARP 
requests from all IP networks/subnets to a mode in which the DI responds 
to ARP requests from IP networks/subnets defined by ADDARN. ADDARN 
limits the functionality of ARP proxy to prevent inefficient routing and 
broadcast loops. 

ADDARN is not required to configure ARP. Omitting it informs ARP to 
answer ARP requests received on all Ethernets to which it connects. 

ADD.ARP.REPORTED NETS 

SOURCE _IP_NETWORK = list 1..4 of 0..255 

DESTINATION JP_NETWORK = list 1..32 of list 1..4 of 0.. 255 or 

keyword value 

SOURCE _IP_NETWORK (SIN) 

ARP requests received from this specified IP network/subnet are eligible 
for a reply if the target IP address is on one of the specified destination IP 
networks. (See DESTINATION _IP_NETWORK parameter.) The format is 
similar to the decimal octet convention used by TCP/IP, except periods are 
replaced with commas and the list is enclosed in parentheses. For example, 
the IP network 192.2.53.0 is represented as (192,2,53,0) or (192,2,53). 

DESTINATION _[P_NETWORK (DIN) 

List of IP networks/subnets reportable via an ARP reply. Specify this 
parameter as a list, or use keyword values NONE or ALL. 

Keyword Value Description 

NONE 

ALL 

Default is ALL. 



ARP proxy disabled. Only ARP requests with a 
target IP address on the SOURCE _IP_NETWORK 
are considered for a reply. 

ARP proxy in effect for all IP networks/subnets. 



Reportable IP network/subnet is added for source IP network/subnet 
< source _ip _network > . 

-ERROR- Reportable IP network/subnet is already defined for source IP 
network < source _ip .network >. 

-ERROR- IP network < source _ip .network > is not defined. 

-ERROR- IP subnet < source _ip .network > is not defined. 

-ERROR- IP network/subnet < source _ip .network > is not directly 
connected. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Remarks This command is useful to prevent ARP looping and to reduce Ethernet 
traffic. 

Examples The following example shows how to use this command. Given the 

configuration in figure 3-1, if the source host sends IP datagrams to a 
destination host, a potential ARP broadcast loop can occur. ADD_ARP_ 
REPORTED_NETS can prevent the ARP broadcast loop. 



NETWORK 
1 



NETWORK 
2 



NETWORK 
3 

















Dl 1 


— I 


SOURCE 
HOST 
















DI 2 


— I 















Dl 3 



DESTINATION 
HOST 
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Figure 3-1. ADD_ARP_REPORTED_NETS Example 

The source host sends an ARP request on network 1 to determine the 
destination host's Ethernet address. DI 1 and DI 2 propagate the ARP 
request on network 2 to search for network 3 (the network where the 
destination host resides). DI 3 sees both ARP requests and replies to both 
DI 1 and DI 2, since it directly connects to network 3. However, DI 1 and 
DI 2 see each others* ARP request and propagate it on network 1 
searching for network 3. This cycle continues until the instigating ARP 
request is answered. 

If one of the DIs connecting networks 1 and 2 is disabled to respond to 
ARP requests for network 3, the broadcast loop is avoided. This is done by 
entering the following commands in DI 2's configuration file: 

add_arp_reported_nets . . 
source_1p_network=1 . . 
dest i nat 1 on_1 p_net work- ( ( 1 ) , ( 2 ) ) 

add_arp_reported_nets . . 
source_1p_network=2 .. 
dest1nat1on_1p_network=((1),(2)) 

These commands inform DI 2 to process ARP requests received on either of 
its connected Ethernet networks only for target networks 1 and 2. This 
enables DI 1 to propagate only the ARP request on network 2. The source 
host can use either DI 1 or DI 2 to reach the destination host. 
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ADD_CLNS_FILTER (ADDCF) 



ADD _CLNS .FILTER (ADDCF) 
NETOU Command 



Purpose 



Format 



Parameters 



Creates a CLNS filter entry for the specified network. As CLNS datagrams 
are received on the specified network, the source and destination NSAP 
addresses are compared to CLNS filter entries. For the addresses to match, 
only the address prefix portion must match. For the entry to be used, both 
the source and destination addresses must match. The CLNS filter entry 
specifies whether the matching CLNS datagram is to be routed or 
discarded. 

During filter processing, CLNS filter entries with longer source address 
prefixes are tried first. For entries with equal source address lengths, the 
longer destination address prefixes are used first. In this way, CLNS filter 
entries with more specific (that is, longer) NSAP address prefixes will be 
used sooner. The length of address prefixes specified as ANY are 
considered to be zero. 

ADD_CLNS .FILTER 

NETWORK .NAME = name 

SOURCE .ADDRESS .PREFIX = string 2..40 or ANY 
DESTINATION .ADDRESS .PREFIX = string 2..40 or ANY 
ACCESS .ALLOWED = boolean 

NETWORK .NAME (NN) 

Identifies the name of a network defined in this system. This is the 
network to which the CLNS filter entry is added. 

SOURCE .ADDRESS .PREFIX (SAP) 

Specifies the NSAP address prefix used to match source addresses of 
datagrams routed through the network. A source address match occurs if 
any leading portion (including all) of the source NSAP address from the 
datagram matches this value. ANY specifies that a match occurs for any 
CLNS datagram whose destination address matches this CLNS filter entry. 
The elements of the string defining an address prefix must be hexadecimal 
digits. An address prefix must include an even number of hexadecimal 
digits. 

DESTINATION .ADDRESS .PREFIX (DAP) 

Specifies the NSAP address prefix used to match destination addresses of 
datagrams routed through the network. A destination address match occurs 
if any leading portion (including all) of the destination NSAP address from 
the datagram matches this value. ANY specifies that a match occurs for 
any CLNS datagram whose source address matches this CLNS filter entry. 
The elements of the string defining an address prefix must be hexadecimal 
digits. An address prefix must include an even number of hexadecimal 
digits. 

ACCESS .ALLOWED (AA) 

Specifies whether a CLNS datagram matching this entry is routed. If 
TRUE, the datagram is forwarded. If FALSE, the datagram is discarded 
The default is TRUE. 
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Responses The CLNS filter entry is added to network < network _name> as follows: 



Examples 



Source NSAP address prefix 
Destination NSAP address prefix 
Access allowed 



< source _NSAP_address_prefix > 

< destination_NSAP_address _prefix > 

< access _allo wed > 



-ERROR— Network < network _name> is not defined. 

-ERROR- This CLNS filter definition is already defined. 

-ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 

-ERROR- The NSAP address prefix < address _prefix> contains an odd 
number of digits. 

—FATAL- Not enough memory available for required table space. 

add_clns_f i Iter network_name=NETW0RK1 source_address_pref 1x='00470023' 
dest 1 nat 1 on_addr ess_pr ef i x= ' 0032004556 * access_a 1 1 owed=TRUE 

The CLNS filter entry Is added to network NETWORK1 as follows 



Source NSAP address prefix 00470023 

Destination NSAP address prefix 0032004556 
Access allowed TRUE 



add_clns_f 1 1ter network_name=NETW0RK2 source_address_prefix=' 00470023' 
dest 1 nat 1 on_address_pr ef 1 x= ' 0032004556 ' access.a 1 1 owed-TRUE 

—ERROR— Network NETW0RK2 Is not defined. 



add_clns_f 1 1ter network_name=NETW0RK1 source_address_pref1x=' 00470023' 
dest 1 nat 1on_address_pref ix='0032004556' access.al lowed=TRUE 

—ERROR— This CLNS filter definition Is already defined. 



add_clns_f 1 1ter network_name=NETW0RK2 source_address_pref 1x='004700FG' 
dest 1 nat i on_addr ess_pref 1 x= ' 0032004556 ' access.a 1 1 owed»TRUE 

—ERROR— The NSAP address prefix 004700FG contains non-hexadecimal 
characters. 
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ADD_CONS_INCALL (ADDCI) 

DI Configuration Procedure/NETOU Command 



Purpose 



Defines a CONS incall definition. An incall definition is from the 
perspective of the CDCNET network. The incall information controls X.25 
calls coming into the CDCNET network destined for CONS. 

The source NSAP address associates the incoming call with the incall 
definition. The source NSAP address is either specified in an X.25 facility 
(the Address Extension Facility) for a 1984 PDN or is obtained from the 
static mapping table defined by ADD_CONS_1980_X25 .MAPPING for a 
1980 PDN. 



Format 



Parameters 



ADD.CONS .INCALL 

ADDRESS .PREFIX = string 2..40 

ACCEPT JPDN JCHARGES = boolean 

ADDRESS .PREFIX (AP) 

Specifies the address prefix of the peer's NSAP address (the source NSAP 
address) for this incall definition. The address prefix can be any leading 
portion of the NSAP address. The address prefix can associate the incall 
definition with multiple NSAP addresses. If multiple ADD_CONS .INCALL 
definitions exist that match a given NSAP address, the call definition 
associated with the longest string is used. The elements of the string you 
enter must contain an even number of hexadecimal digits. 

ACCEPT _PDN JCHARGES (APC) 

Specifies how calls initiated from the peer CONS user should be handled. 
If TRUE, a call is accepted with either normal or reverse charging. If 
FALSE, a call is accepted with only normal charging. Default is FALSE. 

Responses The information for CONS incall definition is added as follows: 

NSAP address prefix = < address .prefix > 
Accept PDN charges = < accept _pdn .charges > 

-ERROR- The CONS incall definition is already defined as follows: 

NSAP address prefix = < address .prefix > 
Accept PDN charges = < accept _pdn .charges > 

-ERROR- The NSAP address prefix < address .prefix > contains 
non-hexadecimal characters. 

-ERROR- The NSAP address prefix < address .prefix > contains an odd 
number of digits. 

—FATAL- Not enough memory available for required table space. 
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Examples add_cons_ incall address_prefix='00470023' accept_pdn_charges' = TRUE 

The CONS incall definition 1s added as follows: 

NSAP address prefix 00470023 
Accept PDN charges TRUE 

add.cons.lncall address_pref ix='00470023' accept jxm_charges«FALSE 

—ERROR— The CONS incall definition 1s already defined as 

NSAP address prefix 00470023 
Accept PDN charges TRUE 

add_cons_incal 1 address_prefix='004700FS' accept_pdn_charges=TRUE 

—ERROR— The NSAP address prefix 004700FG contains non-hexadecimal characters. 
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ADD_CONS_OUTCALL (ADDCO) 

DI Configuration Procedure/NETOU Command 

Purpose Defines a CONS outcall definition. An outcall definition is from the 

perspective of the CDCNET network. CDCNET uses the outcall information 
to generate the proper CONS/X.25 call requests to the public data network. 

The destination NSAP address associates the outgoing call with the outcall 
definition. A CONS user internally specifies the destination NSAP address. 
Indirectly, the destination NSAP address may have been configured by the 
NAM/VE command ADD_OSI_ADDRESS or obtained by directory services. 

There are multiple facility parameters. In addition to the facilities that can 
be added by these parameters, there are other facilities that can be added 
by the CONS entity. For 1980 and 1984 PDNs, the packet size facility can 
be added, based on the setting of the SUBSCRIBED_FACILITIES 
parameter of DEFINE _X25 .INTERFACE. For 1984 PDNs, the expedited 
data negotiation facility (with value FALSE) and the called and calling 
address extension facilities (with values based on the corresponding NSAP 
addresses) are added. 

When you specify two or more categories, facility markers (two octets in 
length) are automatically inserted between each of the categories of 
facilities (X25 .FACILITIES, LOCAL _NON_X25 .FACILITIES, REMOTE. 
NON.X25 .FACILITIES, and CCITT.DTE .FACILITIES). 

Format ADD.CONS .OUTCALL 

ADDRESS .PREFIX = string 2..40 

REMOTE JDTE _ADDRESS = string 1..15 

LOCAL JDTE ^ADDRESS = string 1. .15 

ADD ^REVERSE _CHARGES = boolean 

ADD_FASTJ3ELECT = boolean 

INTERFACE _STANDARD = key 

X25 JFACILITIES = string 2..218 

LOCAL _NON JK25 J?ACILITIES = string 2. .218 

REMOTE _NON _X25 JFACILITIES = string 2..218 

CCITTJDTE _FACIUTIES = string 2..218 

USERJDATA = string 2.256 

Parameters ADDRESS .PREFIX (AP) 

Specifies the address prefix of the peer's NSAP address (the destination 
NSAP address) for this incall definition. The address prefix can be any 
leading portion of the NSAP address. The address prefix can associate the 
outcall definition with multiple NSAP addresses. If multiple ADD.CONS. 
INCALL definitions exist that match a given NSAP address, the call 
definition associated with the longest string is used. The elements of the 
string you enter must contain an even number of hexadecimal digits. 

REMOTE JDTE ^ADDRESS (RDA) 

Specifies the X.25-calIed DTE address used when a virtual circuit is 
created in order to transmit data to the associated NSAP address. Specify 
this parameter as a string of digits. 
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For NSAP addresses where the next hop trunk is an X.25 trunk, 
REMOTE _DTE .ADDRESS must be specified on the ADD_NON_CDC_ 
ROUTING.ENTRY or ADD_CONS_OUTCALL commands. If specified by 
both, the ADD_CONS_OUTCALL command takes precedence. If specified 
by neither, any CONS connect request to the NSAP is rejected. If the next 
hop trunk is an X.25 trunk identified internally by dynamic routing by an 
X.25 network solution, the other remote DTE address is the one defined by 
DEFINE_X25.NET, not ADD_NON_CDC_ROUTING_ENTRY. The 
default for Ether (LLC_2) and HDLC trunks is that the called DTE 
address is zero length. 

LOCAL _PTE ^ADDRESS (LDA) 

Specifies the X.25 calling DTE address used when creating a virtual circuit 
to transmit data to the associated NSAP address. Specify this parameter as 
a string of digits through 9. 

For NSAP addresses where the next hop trunk is an X.25 trunk, LOCAL _ 
DTE .ADDRESS can be specified on either the DEFINE _X25 .INTERFACE 
or ADD_CONS_OUTCALL commands. If specified by both, the ADD_ 
CONS_OUTCALL command takes precedence. If specified by neither, any 
CONS connect request to the NSAP address has a zero length calling DTE. 
The default for Ether (LLC_2) and HDLC trunks is that the calling DTE 
address is zero length. 

ADD_REVERSE _CHARGES (ARC) 

Specifies whether to use the reverse charges facility for outgoing calls. If 
TRUE, the reverse charges facility is included in outgoing calls. If FALSE, 
reverse charging will not be requested. The default is FALSE. 

ADD J AST ^SELECT (AFS) 

Specifies whether to use the fast select facility for outgoing calls. If TRUE, 
the fast select facility is included in outgoing calls. If user data is greater 
than 16 octets, this parameter is automatically set to TRUE. Otherwise, 
the default is FALSE. 

INTERFACE STANDARD (IS) 

Specifies which X.25 standard to use when formatting the call for a given 
trunk. 

SAME _AS .INTERFACE 

Specifies that CONS use the value defined for the actual trunk by the 
DEFINE .X25 .INTERFACE command (could be either CCITT_1980 or 
CCITT_1984). 

CCITT_1980 

Specifies that CONS formats the call using the 1980 CCITT standard 
no matter what value the DEFINE _X25 _INTERFA.CE command 
specifies. A CCITT_1980 call does not include certain facilities 
(expedited data negotiation and address extension) that are present in a 
CCITT_1984 call. 

The default is SAME _AS .INTERFACE. 
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X25 FACILITIES (XF) 

Specifies X.25 facilities options as defined by the X.25 CCITT protocol. 
This parameter is specified as an even-numbered string of hexadecimal 
digits. There is no additional validation performed on the string other than 
to check that the length of all the facilities plus implied markers specified 
by this command does not exceed 109 octets. The default is that no 
additional facilities are generated for this category. 

LOCAL JVON _X25 FACILITIES (LNXF) 

Specifies non-X.25 facilities options provided by the local network as 
allowed by the X.25 CCITT protocol. This parameter is specified as an 
even-numbered string of hexadecimal digits. There is no additional 
validation performed on the string other than to check that the length of 
all the facilities plus implied markers specified by this command does not 
exceed 109 octets. The default is that no facilities are generated for this 
category. 

REMOTE FON F25 FACILITIES (RNXF) 

Specifies non-X.25 facilities options provided by the remote network as 
allowed by the X.25 CCITT protocol. This parameter is specified as an 
even-numbered string of hexadecimal digits. There is no additional 
validation performed on the string other than to check that the length of 
all the facilities plus implied markers specified by this command does not 
exceed 109 octets. The default is that no facilities are generated for this 
category. 

CCITT _£>TE FACILITIES (CDF) 

Specifies CCITT DTE facilities options as defined by the X.25 CCITT 
protocol. This parameter is specified as an even-numbered string of 
hexadecimal digits. There is no additional validation performed on the 
string other than to check that the length of all the facilities plus implied 
markers specified by this command does not exceed 109 octets. The default 
is that no additional facilities are generated for this category. 

USER FATA (UD) 

Specifies an even-numbered string of hexadecimal digits. This parameter 
value overrides any user data specified by the CONS user (such as the 
user data propagated from TPO as specified on the CHANGE _OSI_ 
TRANSPORT command) and places the string into the USER_DATA field 
of the X.25 call. The default is to use the user data specified by the CONS 
user. 
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Responses The CONS outcall definition is added as follows: 

NSAP address prefix = < address _prefix> 

Remote DTE address = < remote _dte .address > 

Local DTE address = < local _dte .address > 

Add reverse charging = <add_reverse_charges> 

Add fast select = <add_fast_select> 

Interface standard = < interface _standard> 

X.25 facilities = <x25 _facilities> 

Local non-X.25 facilities = < local _non_x25_facilities> 

Remote non-X.25 facilities = < remote _non_x25_facilities> 

CCITT DTE facilities = <ccitt.dte .facilities > 

User Data = <user_data> 

-ERROR- The CONS outcall definition is already defined as follows: 

NSAP address prefix = < address _prefix> 

Remote DTE address = < remote _dte .address > 

Local DTE address = < local _dte_address> 

Add reverse charging = < add ..reverse ..charges > 

Add fast select = <add_fast_select> 

Interface standard = < interface _standard> 

X.25 facilities = <x25_facilities> 

Local non-X.25 facilities = < local _non_x25 .facilities > 

Remote non-X.25 facilities = < remote _non_x25_facilities> 

CCITT DTE facilities = <ccitt_dte facilities > 

User Data = <user_data> 

-ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. -ERROR- The NSAP address prefix 
< address _prefix> contains an odd number of digits. 

—ERROR- DTE address < string > contains non- decimal characters. 

-ERROR- Facilities <string> contains non-hexadecimal characters. 

-ERROR- Facilities <string> contains an odd number of digits. 

-ERROR- Specified facilities total length of < number > octets exceeds the 
maximum of 109 octets. 

-ERROR- User .data < string > contains non-hexadecimal characters. 

-ERROR- User_data < string > contains an odd number of digits. 

-FATAL- Not enough memory available for required table space. 
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Examples add.cons.outcal 1 address_prefix=' 00470023' remote_dte_address«' 123456789' 

add_reverse_charges=TRUE remote.non.x25.fac 1 1 i 1 1 es» ' 11 2233 ' 

The CONS outran definition 1s added as follows: 



nsap address prefix 
Remote DTE address 
Local DTE address 
Add reverse charging 
Add fast select 
Interface standard 
X.25 facilities 
Local non-X.25 facilities 
Remote non-X.25 facilities 
CCITT DTE facilities 
User Data 



00470023 

123456789 

None specified 

TRUE 

FALSE 

SAME.AS.1NTERFACE 

None specified 

None specif led 

112233 

None specified 

CONS user specified 



add.cons.outcal 1 address.pref tx='00470023' add_fast.seiect«TRUE .. 
remote_non_x25_f act 1 it ies='998877 ' 

—ERROR— The CONS outoall definition is already defined as follows: 



NSAP address prefix 
Remote DTE address 
Local DTE address 
Add reverse charging 
Add fast select 
Interface standard 
X.25 facilities 
Local non-X.25 facilities 
Remote non-X.25 facilities 
CCITT DTE facilities 
User Data 



00470023 
123456789 
None specified 

TRUE 

FALSE 

SAME.AS.INTERFACE 

None specif ied 

None specified 

112233 

None specified 

CONS user specified 



add.cons.outcal 1 address_prefix='004700F6' user_aata ,s '030l0100' 
—ERROR— The NSAP address prefix 004700FQ contains non-hexadecimal characters. 
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ADD_CONS _1980 _X25 JMAPPING (ADDC1XM) 
DI Configuration Procedure/NETOU Command 

Purpose Configures the information incoming from an X.25 PDN needed to route 

CONS/TPO traffic to the proper destination. 

ADD_CONS_1980_X25 .MAPPING defines the following information: 

• The destination NSAP address 

• The destination (called) DTE address 

• The source NSAP address 

• The source (calling) DTE address 

The ADDC1XM command can be entered repeatedly. This may be 
necessary if more than one destination DTE/NSAP address and source 
DTE/NSAP address association exists. 

Format ADD_CONS_1980_X25 .MAPPING 

DESTINATION _NSAP_ADDRESS = string 2..40 

DESTINATION J)TE _ADDRESS = string 1..15 
SOURCE _J!SAP_ADDRESS = string 2..40 
SOURCE _DTE ^ADDRESS = string 1..15 

Parameters DESTINATION _NSAP_ADDRESS (DNA) 

Specifies the destination NSAP address used for all X.25 Incoming Call 
packets containing called and calling DTE addresses matching the values 
established by the DESTINATION _DTE .ADDRESS and SOURCE _DTE_ 
ADDRESS parameters of this command. These Call packets cause a 
corresponding CONS connection to be made to the destination NSAP 
address specified by this parameter. 

The elements of the string you enter must contain an even number of 
hexadecimal digits. 

DESTINATION _X>TE _ADDRESS (DDA) 

Specifies the destination DTE address used for mapping the called DTE 
address of X.25 Incoming Call packets to the destination NSAP address 
specified by the DESTINATION _NSAP_ADDRESS parameter of this 
command. Default is no called DTE address (Incoming Call packets that do 
not contain a called DTE address are considered matching). 

The called and calling DTE addresses of Incoming Call packets must match 
the values established by the SDA parameter and this parameter before 
the SDAP addresses specified by this command occur. 

The elements of the string you enter must contain decimal digits. 
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SOURCE JV SAP .ADDRESS (SNA) 

Specifies the source NSAP address used for all X.25 Incoming Call packets 
containing called and calling DTE addresses matching the values 
established by the DESTINATION _DTE_ADDRESS and SOURCE _DTE_ 
ADDRESS parameters. These Call packets cause a corresponding CONS 
connection to be made to the NSAP address specified by the 
DESTINATION _NSAP_ADDRESS parameter. The source NSAP address 
used for the CONS connection is the value specified by this parameter. The 
default for this parameter is the NSAP address of this system. 

The elements of the string you enter must contain an even number of 
hexadecimal digits. 

If an entry is given in which no source DTE address is supplied but a 
source NSAP is supplied, and an incoming call contains no source DTE 
address but a destination DTE address that matches this entry, then the 
entry is considered found and the supplied NSAP address is used instead of 
the default. 

If the call source may be from two different systems, the correct NSAP 
address should be entered because the Transport protocol, which states the 
source NSAP address along with the source Transport reference number, 
must be unique. If they are not unique, unexpected results such as 
disconnects or hung connections may occur. 

Also, the destination end system may require the correct source NSAP 
address for validation purposes. For example, with the RTS (Reliable 
Transfer Service) application on at the NOS/VE host, the incoming call is 
validated by the source NSAP address. The source NSAP address given to 
the RTS application must match the source NSAP address given on this 
command. 

For the RTS application on the NOS/VE host, the command, ADD_OSI_ 
ADDRESS (ADDOSIA), must be executed for the NSAP address of the 
incoming call destination. For RTS to pass the incoming validation check, 
the address given to ADDOSIA must match the source NSAP address. No 
such requirement exists for FTAM. 

SOURCE JDTE ^ADDRESS (SDA) 

Specifies the source DTE address used for mapping the calling DTE 
address of X.25 Incoming Call packets to the source NSAP address 
specified by the SNA parameter of this command. Default is no calling 
DTE address (Incoming Call packets that do not contain a calling DTE 
address are considered matching). 

NOTE 

Both the called and calling DTE addresses of Incoming Call packets must 
match the values established by the DDA parameter and this parameter 
before the mapping to the NSAP addresses specified by this command 
occurs. 



The elements of the string entered must contain decimal digits. 
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It is not required that an incoming X.25 Connect Request from an X.25 
PDN contain a calling (source) DTE address. This information is needed if 
the destined system needs to know the origination of the call and the 
destination DTE address is not enough to determine this information. For 
example, if this NDI expects to receive only incoming CONS/TPO traffic 
over an X.25 PDN from one foreign system, then the source NSAP address 
can be determined from the incoming called (destination) DTE address. 
If this NDI expects to receive incoming CONS/TPO traffic over an X.25 
PDN from more than one foreign system, but each foreign system is 
sending data to a different destination system, the source NSAP address 
can be determined from the destination DTE address. 

If the incoming call contains a source DTE address, then it must be 
supplied in order for this entry to match. 

Responses The information for routing incoming CONS/TPO traffic is added as follows: 

Destination NSAP address = < destination _nsap_address> 
Destination DTE address = < destination _dte .address > 
Source NSAP address = < source _nsap_address> 
Source DTE address = < source _dte_address> 

-ERROR- The NSAP address <nsap address > contains non-hexadecimal 
characters. 

-ERROR- The NSAP address <nsap address > contains an odd number of 
digits. 

-ERROR- The DTE address <dte address > contains non-decimal 
characters. 

-ERROR- The information for routing incoming CONS/TPO traffic is 
already defined as follows: 

Destination NSAP address = < destination _nsap_address> 
Destination DTE address = < destination _dte_address> 
Source NSAP address = < source _nsap_address> 
Source DTE address = < source _dte_address> 

-FATAL- Not enough memory is currently available for required table 
space. 
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Examples add_cons_1980_x25_mapp1ng dda*' 1234567' .. 

dna='39840f01bb7b0000000000000108002B10008401' . . 
sda»'789012' sna» '4700040003000 1202301 10070001' 

The Information for routing Incoming CONS/TP0 traffic is 
added as follows: 

Destination NSAP address - 39840f01bb7b0000000000000108002510008401 

Destination DTE address = 1234567 

Source NSAP address = 4700040003000120230110070001 

Source DTE address - 789012 



add_cons_1980_x25_mapp1ng .. 
dna* ' 39840f 1 bb7b0000000000000 108002510008401' 

The Information for routing Incoming CONS/TP0 traffic Is 
added as follows: 

Destination NSAP address = 39840f01bb7b0000000000000108002510008401 
Destination DTE address - Not Specified 

Source NSAP address = 39840f01bb7b0000000000000108002510007201 
Source DTE address = Not Specified 



addclxm dda*' 1234567' dna*'0000000008002510008G' 

—ERROR— The NSAP address 00000000080025 10008G 
contains non-hexadecimal characters. 



addclxm dda='12345FF' dna='0000000008002510008G' 
— ERROR— The DTE address 12345FF contains non-decimal characters. 



addclxm dda=' 1234567' 
dna= '39840f 1bb7b0000000000000 10800251 000840 1 ' 

—ERROR— The Information for routing incoming 
CONS/TP0 traffic is already defined as follows: 

Destination NSAP address - 39840f01bb7b0000000000000108002510008401 
Destination DTE address - 1234567 

Source NSAP address = 39840f01bb7b00000000000001080025l0007201 
Source DTE address «■ Not Specified 
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ADD _EGP_REPORTED _NETS (ADDERN) 
DI Configuration Procedure/NETOU Command 

Purpose Adds the specified IP network numbers to the list of local networks 

reported by Exterior Gateway Protocol (BGP) to its peers for this DI. If the 
list of local networks was previously empty, EGP would have reported all 
local networks to its peers. ADDERN switches EGP from reporting all IP 
networks to reporting only IP networks defined by this command. 

Format ADD _EGP_REPORTED _NETS 

IP_NETWORK a list~1..32 of list 1..3 of 0..255 

Parameters IP_NETWORK (IN) 

List of IP network numbers reported to EGP peers. The format is similar 
to the decimal octet convention used by TCP/IP, except periods are replaced 
with commas, and the list is enclosed in parentheses. In addition, the 
address is a list of three numbers instead of four. Since the address is a 
network address, the host portion is omitted. For example, the IP address 
128.2.53.0 is represented as (128,2,53). 

Responses IP networks are added to the reported EGP list. 

-FATAL- Not enough memory is currently available for required table 
space. 



Remarks 



This command is useful for security. For example, you might want one 
gateway not to know about another gateway. 
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Examples The following example shows how to use this command. Given the 

configuration in figure 3-2, the best path for a DDN host to connect to a 
host on 192.12.251 is through DI 1. Likewise, DI 4 is the best path for a 
DDN host to connect to a host on 192.5.209. Since DI 1 can reach network 
192.5.209, it could report to its EGP peer that 192.5.209 is reachable 
through it. This would cause an inefficient route to 192.5.209. 



h 



192.12.251 



DI 1 



y /- 



192.5.209 



DI 2 




DI 3 



-/ 



DI 4 



EGP 
GATEWAY 



M02897 



Figure 3-2. ADD _EGP_REPORTED _NETS Example 

To cause each gateway to report only its directly connected Ethernet, enter 
the following commands in the DI 1 and DI 4 configuration files. 

For DI 1: 

add_egp_reported_nets 1p_network=((192, 12,251)) 
For DI 4: 

add_egp_reported.net s 1p_network«(( 192,5,209)) 
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ADD .INCOMING .SERVICE .ACCESS (ADDISA) 
DI Configuration Procedure/NETOU Command 

Purpose Adds the titles of servers that may be accessed coming in via the network 
solution. 

Format ADD ..INCOMING _SERVICE _ACCESS 

TITLE = list 1..15 of name or string 1..255 
NETWORK _NAME = name 

Parameters TITLE (T) 

Title of a server that may be accessed coming in via the network solution. 
The title may contain wildcard characters to specify a set of allowed titles 
(see the CDCNET Network Operations and Analysis manual for 
information on wildcard characters). 

Title is case-sensitive when entered as a string. For example, if the 
command defining a service specifies the service title in uppercase, it must 
be specified in uppercase for the ADDISA command or it is seen as a 
different title. 

For more information on the use of service titles, see the CDCNET 
Configuration manual. 

NETWORK _NAME (NN) 

Identifies the name of a currently defined network within this system. This 
is the network solution upon which the accessible services are being 
defined. Defaults to the previously defined network when on the 
configuration file. It is required when the command is entered by the 
operator. 

Responses Incoming service access added to network < network _name>. 

-WARNING- Incoming service access added to network < network _ 

name>. 

Title < title > already added to network. 

{Line repeats for each title already added to network} 

-ERROR- A network is not defined. 

-ERROR- Network < network _name> is not defined. 

-ERROR- Title < title > may not appear more than once in the list of 
specified titles. 

-ERROR- Expecting NAME or STRING, found <xxx>. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Examples ' In this example, an HDLC trunk links two separate sites (figure 3-3). 

Assume that service access between the two sites must be limited to the 
following: 

• QTF/PTF file transfers in either direction. 

• Site 1 has unrestricted interactive service access to site 2. 

• Site 2 interactive service access to site 1 is limited to Host_l. 
Add the following to the configuration file for NDI_1: 

def1ne_hd1c_net. . 

trunk_name=hdlc_trunk_1 ,network_name*hdlc_net_1 , . . 

network_id=3. . 

1ncoming_servlce_access=(f i le.transfer) . . 

outgo1ng_service_access=(fiie_transfer, Interactive) 
add_incom1ng_service_access. . 

t1tle=host_1 

The ADD .INCOMING .SERVICE .ACCESS command adds Host_l as the 
only site 1 host to which site 2 users can make an interactive connection. 
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Figure 3-3. ADDISA Example 
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ADD_IP_FILTER (ADDIF) 
NETOU Command 

Purpose Creates an IP filter entry for the specified IP network. As IP datagrams 

are received on the specified network, the system compares the protocol, IP 
addresses, and port numbers to IP filter entries. The portions of the IP 
addresses used are determined by the masks. When an IP datagram is 
processed, a particular filter entry is selected if all its parameters match 
the IP datagram. A value of ANY for a parameter specifies that any value 
for that item from the datagram is a match. The ACCESS _ALLOWED 
parameter from the IP filter entry specifies whether the matching IP 
datagram is to be routed or discarded. When a datagram is discarded, a 
statistics field and a MIB variable are incremented. The order of IP filter 
entries used is the same as the order in which they are created. The 
system administrator can use masks and change the order created to cause 
different effects with similar addresses. 

Format ADD_IP_FILTER 

IP.NETWORK = list 1..4 of integer 0..255 

SOURCE _IP_ADDRESS = list 1..4 of integer 0..255 or ANY 

DESTINATION _IP_ADDRESS = list 1..4 of integer 0..255 or ANY 

SOURCE _IP_M ASK = list 1..4 of integer 0.255 or HOST 

DESTINATION _JP_tfASK = list 1..4 of integer 0..25 or HOST 

PROTOCOL = integer 1.254 or keyword value 

SOURCE _PORT_NUMBER = list 1..10 of integer 0.. 65535 or ANY 

DESTINATION JPORT_NUMBER = list 1..10 of integer 0.. 65535 or 

ANY 
ACCESS ^ALLOWED = boolean 
NUMBER .DATAGRAMS JOGGED = integer 0.255 

Parameters IP.NETWORK (IN) 

Identifies an IP network defined in this system. This is the network to 
which the IP filter entry is added. 

SOURCE _IP_ADDRESS (SIA) 

Specifies the IP address used to filter source IP addresses from datagrams 
received on this IP network. A source address match occurs if the source 
IP address from the datagram matches this value after applying the 
SOURCE _EP_MASK parameter. ANY specifies that any source IP address 
in the datagram satisfies this part of the match. 

DESTINATION _IP_ADDRESS (DIA) 

Specifies the IP address used to filter destination IP addresses from 
datagrams received on this IP network. A destination address match occurs 
if the destination IP address from the datagram matches this value after 
applying the DESTINATION _IP_MASK parameter. ANY specifies that any 
destination IP address in the datagram satisfies this part of the match. 

SOURCE JP.MASK (SIM) 

Specifies which parts of the SOURCE _IP_ADDRESS parameter are 
compared to the IP datagram's source address to determine a source 
address match. List items not included default to zeros. The keyword 
HOST uses (255,255,255,255) to specify that the entire source IP address is 
compared. This parameter is not used if the SOURCE _IP_ADDRESS 
parameter is ANY. The default is HOST. 
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DESTINATION _JP_MASK (DIM) 

Specifies which parts of the DESTINATION _IP_ADDRESS parameter are 
compared to the IP datagram's destination address to determine a 
destination address match. List items not included default to zeros. The 
keyword HOST uses (255,255,255,255) to specify that the entire destination 
IP address is compared. This parameter is not used if the DESTINATION. 
IP_ADDRESS parameter is ANY. The default is HOST. 

PROTOCOL (P) 

Specifies the datagram protocol filtering to use for this entry. A protocol 
match occurs if the protocol field in the IP datagram matches this value. 
The keywords ICMP, TCP, and UDP specify corresponding protocol values; 
ANY indicates that any protocol value matches. The default is ANY. 

SOURCE _PORT ^NUMBER (SPN) 

Specifies ranges of source port number values used to filter the datagram's 
source port field received on the specified IP network. A match occurs if 
the source port number from the datagrams falls into any of the specified 
ranges. ANY specifies that any source port number from the datagram 
satisfies this part of the match. Only protocol TCP and UDP datagrams 
include source and destination port numbers. For a filter entry to match a 
datagram that does not include a source port number, the filter entry must 
specify ANY. The default is ANY. 

DESTINATION _PORT_NUMBER (DPN) 

Specifies ranges of destination port number values used to filter the 
datagram's destination port field received on the specified IP network. A 
match occurs if the destination port number from the datagrams falls into 
any of the specified ranges. ANY specifies that any destination port 
number from the datagram satisfies this part of the match. Only protocol 
TCP and UDP datagrams include source and destination port numbers. For 
a filter entry to match a datagram that does not include a destination port 
number, the filter entry must specify ANY. The default is ANY. 

ACCESS ^ALLOWED (AA) 

Specifies whether an IP datagram matching this entry is routed. If TRUE, 
the datagram is forwarded. If FALSE, the datagram is discarded. The 
default is TRUE. 

NUMBER JDATAGRAMS _LOGGED (NDL) 

Specifies how many of the filtered IP datagrams should be logged in a 
given statistics interval. The logging occurs only if DOD_INTERNET is 
specified on the PROCESS parameter of the START_PROCESS .METRICS 
command. The log message recording the filtered datagrams is log ID 1712. 
The default is 0. 
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Responses The IP filter entry is added to network <ip_network> as follows: 



Examples 



Source IP address 

Destination IP address 

Source IP mask 

Destination IP mask 

Protocol 

Source port ranges 

Destination port ranges 

Access allowed 

Number datagrams logged 



< source _ip _address > 

< destination _ip _address > 

< source _ip _mask > 

< destination _ip _mask > 

< protocol > 

< source _port _number > 

< destination _port _number > 

< access _allowed > 

< number _datagrams _logged > 



-ERROR- IP network <ip_network> is not defined. 

-ERROR- The IP Filter entry is already defined on IP network <ip. 
network >. 

-FATAL- Not enough memory available for required table space. 

add_1p_filter ip_network=( 129, 179,52) source_ip_address=(129,l79) .. 
dest1nation_1p_address=( 129, 179,63) source_1p_mask=(255,255) .. 
dest i nat ion_ip_mask=host protocol*any source_port_number=1 . . 126 .. 
dest i nat ion_port_number= 127 . . 255 access_al lowed=TRUE 
number_dat agrams_ 1 ogged= 1 



The IP filter entry is added to IP network 129,179,56 as follows: 



Source IP address 

Destination IP address 

Source IP mask 

Destination IP mask 

Protocol 

Source port ranges 

Destination port ranges 

Access allowed 

Number datagrams logged 



129.179.000.000 

129.179.630.000 

255.255.000.000 

255.255.255.255 

any 

1..126 

127.. 255 

TRUE 

10 



add_1p_f liter 1p_network=( 129, 179,54) source_1p_address«(129,179) 
dest 1 nat 1on_1p_address=( 129, 179,63) source_1p_mask=(255,255) .. 
dest 1 nat 1on_1p_mask=host protocol=any sour ce_port .number = 1. . 126 
dest1nation_port_number=l27..255 access_a!1owed=TRUE .. 
number_datagrams_logged=10 

—ERROR— IP network 179,179,54 1s not defined. 



add_1p_filter 1p_network=( 129, 179,52) source_1p_address=(129,179) 
dest1nat1on_1p_address=(129, 179,63) source_1p_mask«(255,255) .. 
dest 1 nat 1on_1p_mask=host protocol=any source_port_number«1..126 
dest 1 nat 1on_port_number-127 . .255 access_al lowed=TRUE . . 
number_dat agr ams_ 1 ogged= 1 



—ERROR— The IP filter definition 1s already defined on 
IP network 129,179,52 
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ADD.NON _CDC .ADDRESS .PREFIX (ADDNCAP) 
DI Configuration Procedure/NETOU Command 

Purpose Defines information used to route traffic to a non-CDCNET OSI system. 
This information includes a list of address prefixes of NSAP addresses in 
one or more non-CDCNET systems which can be reached from the same 
CDCNET boundary system. 

Format ADD.NON _CDC .ADDRESS .PREFIX 

ADDRESS .PREFIX = list 1..10 of string 2..40 
NEXT_JIOP = list 1..4 of 0..0FFFF, string of 12 

Parameters ADDRESS .PREFIX (AP) 

Specifies the address prefix of non-CDCNET NSAP addresses for which the 
boundary system is being defined. The elements of each string defining an 
address prefix must be hexadecimal digits. An address prefix must include 
an even number of hexadecimal digits. 

NEXT_MOP (NH) 

Specifies information for up to four boundary systems, any of which can be 
used to reach the non-CDCNET systems whose NSAP addresses are 
identified via the AP parameter. 

Information about each boundary system is specified by a subnet ID and 
SNPA address pair. The subnet ID identifies a CDCNET subnet directly 
connected to the boundary system. The SNPA address is the layer 1 
address of the boundary system on this subnet. It is same as the system 
ID of the boundary system. 

The subnet ID is specified as an integer with a value between and Offff. 

The SNPA address is specified as a string containing 12 hexadecimal 
digits. 

Responses The following header precedes the added address prefixes. 

The NonCDCNET NSAP address prefixes are added as follows (see 
example): 

The following responses are error messages. 

-ERROR- The NonCDCNET NSAP address prefixes are already defined 
as follows (see examples for the format): 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains non-hexadecimal characters. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains an odd number of digits. 

-ERROR- SNPA <next.hop SNPA> contains non-hexadecimal 
characters. 

-ERROR- This command cannot be executed in a system whose routing 
function is END SYSTEM. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Examples add_non_cdc_addPess_pref 1 x ap='00470023' nh = ((15,'0800271000EE'), 

(1, '080027100123')) 

The NonCDCNET NSAP address prefixes are added as follows: 

NonCDCNET NSAP address prefix Subnet ID Boundary System SNPA 

00470023 000F 080027 1000EE 

0001 080027100123 



add_non_cdc_address_pref 1 x ap='004700FG' nh=( ( 15, '00EEFF3324EE' ) ) 

—ERROR— The NonCDCNET NSAP address prefix 004700FG contains 
non-hexadecimal characters. 



add_non_cdc_address_pref ix ap='004700FG' nh=( ( 15, '00EEFG3324EE' ) ) 

—ERROR— SNPA 00EEFG3324EE contains non-hexadecimal characters. 
The NonCDCNET NSAP address prefix 004700FG contains 
non-hexadecimal characters. 
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ADD_NON __CDC ^ROUTING JENTRY (ADDNCRE) 
DI Configuration Procedure/NETOU Command 

Purpose Configures the information needed to route traffic to a non-Control Data 
system. This command is executed in a CDCNET boundary system. A 
CDCNET boundary system is the last CDCNET system on the path to a 
non-Control Data destination. It is connected to the same medium to which 
a non-Control Data system is also connected. This non-Control Data system 
is either the final destination or the first non-Control Data next hop on the 
path to it. 

Routing entries defined by the ADD_NON_CDC .ROUTING _ENTRY 
command are automatically deleted if the next hop trunk associated with 
these entries is cancelled using one of the CANCEL _XXX_TRUNK 
commands. 

NOTE 

CDCNET supports routing to non-Control Data systems only through 
Ethernet and HDLC trunks for CLNS traffic and through Ethernet and 
X.25 trunks for CONS traffic. 

Format ADD_NON _CDC .ROUTING _ENTRY 

ADDRESS .PREFIX = list 1..10 of string 2..40 
NEXT.HOP.TRUNK = name 

NEXT^OP_SNPA = string 1..15 
DISTRIBUTE = boolean 

Purpose ADDRESS .PREFIX (AP) 

Specifies the address prefix of NSAP addresses for which the next hop is 
being defined. The elements of each string must be an even number of 
hexadecimal digits. 

NEXT.HOP.TRUNK (NHT) 

Specifies the logical name of the trunk which connects the local system to 
the next hop non-Control Data system. It should be same as the name used 
in the DEFINE .XXX .TRUNK command used to define the trunk. 

NEXT_HOP_SNPA (NHS) 

Specifies the SNPA address of the next hop system on the next hop trunk. 
Its value is specified as a string. The size of the string depends on the 
type of the medium associated with the next hop trunk. 

For Ethernet, the SNPA address is the Ethernet station ID and is specified 
as a string containing 12 hexadecimal digits. 

For X.25 PDN, the SNPA address is the DTE address and is specified as a 
string containing 1 to 15 decimal digits. 

This parameter is not required if the next hop trunk is an HDLC trunk. 
In this case, if a value is specified for this parameter, it is ignored. 

Normally, this parameter is required if the next hop trunk is an Ethernet 
trunk. However, a value for this parameter may not be specified if the 
non-Control Data destination systems identified by the ADDRESS .PREFIX 
parameter, support the ES-IS routing protocol and are directly connected to 
the Ethernet trunk identified, by the NEXT.HOP.TRUNK parameter. 
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A value must be specified for this parameter if the next hop trunk is an 
X.25 trunk. 

DISTRIBUTE (D) 

Indicates whether the specified address prefix(es) should be distributed by 
the CDCNET IS-IS protocol to other CDCNET systems. If the address 
prefix(es) are distributed, intermediate systems can learn the route to the 
boundary system dynamically, as opposed to configuring intermediate 
systems with ADD_NON_CDC .ADDRESS _PREFIX commands. The 
default is TRUE. 

Responses The following header precedes the routing entry display (see example). 

The routing entry is added as follows: 

The following response appears if address prefixes are already defined (see 
examples). 

-ERROR- The routing information for the NonCDCNET NSAP address 
prefixes is already defined as follows: 

The following headers indicate an error message. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains non-hexadecimal characters. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains an odd number of digits. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- LLC 2 trunk < trunk .name > may not be used as the 
next .hop .trunk. 

-ERROR- SNPA <next_hop_snpa> contains non-hexadecimal 
characters. 

-ERROR- SNPA < next .hop _snpa> for the X.25 trunk <next_hop_ 
trunk > contains non- decimal characters. 

-ERROR- SNPA < next .hop _snpa> for the ETHERNET trunk 
< next .hop .trunk > must contain 12 digits. 

—ERROR— This command cannot be executed in a system whose routing 
function is END SYSTEM. 

-FATAL- The maximum number of NonCDCNET NSAP address 
prefixes is already defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks In order to reach a non-Control Data system, routing information must be 
configured by the ADD.NON.CDC .ROUTING .ENTRY command in each 
boundary system through which the non-Control Data destination can be 
reached. This routing information is dynamically distributed to other 
systems through either the standard ES-IS protocol or the CDCNET IS-IS 
protocol. 
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Examples 



When routing information defined by executing both ADD_NON_CDC_ 
ROUTING _ENTRY and ADD_NON_CDC_ADDRESS ..PREFIX commands 
in the same system reaches the same destination, the information defined 
by the ADD_NON_CDC .ROUTING .ENTRY command takes precedence. 
The static routing information received by routing PDUs has lower 
precedence than that statically configured in a given system. 

For CLNS traffic, dynamic routing is attempted first; if it fails, static 
routing is attempted. For CONS traffic, static routing is attempted first; if 
it fails, dynamic routing is attempted. 

The maximum number of non-Control Data address prefixes which may be 
configured in a given boundary system is 71-N. N represents the number 
of directly connected subnets. A minimum value of 10 is assumed for N. 
Therefore, no more than 61 non-Control Data address prefixes can be 
configured in a given CDCNET system. However, if the actual number of 
directly connected subnets is greater than 10, then the actual number is 
used for N resulting in a lower upper limit for the maximum number of 
non-Control Data address prefixes. 

add_non_cdc_rout 1 ng_ent ry ap= ( ' 00470023' , '390840 ' ) . . 
nht = ether net _trunk_one nhs » '0800271000EE' 



The routing entry is added as follows: 



NSAP address prefixes 

Next hop trunk 

Next hop SNPA address 

Distribute 



00470023 

390840 

ethernet_trunk_one 

080027 1000EE 

TRUE 



add_non_cdc_rout1ng_entry ap= '004700EE' nht ■ x25_trunk_1 
nhs = '293117234053' d=FALSE 

The routing entry is added as follows: 



NSAP address prefixes 
Next hop trunk 
Next hop SNPA address 
Distribute 



004700EE 
x25_trunk_1 
293117234053 
FALSE 



add_non_cdc_routing_entry ap«'004700FG' nht« $ESCI01 nhs « '08002530413F' 

—ERROR— The NonCDCNET NSAP address prefix 004700FG contains 
non-hexadecimal characters. 



add_non_cdc_rout1ng_entry ap-'004700F' nht* $ESCI01 nhs » '08002530413F' 

—ERROR— The NonCDCNET NSAP address prefix 004700F contains 
an odd number of digits. 
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ADD_NP_GW_OUTCALL (ADDNGO) (NOS only) 
DI Configuration Procedure/NETOU Command 

Purpose Creates a NOS Network Products (NP) gateway outcall definition. Outcall 
is from the perspective of the CDCNET network; that is, the call goes out 
of CDCNET. Outcall information generates the proper call request into the 
NOS host. An NP gateway outcall definition consists of an NP application 
name and the corresponding CDCNET title by which the gateway is known 
throughout CDCNET. Titles are site-definable and conform to CDCNET 
title conventions. Example titles are PTFS$M80 and QTFS$LID. 

See also the DEFINE _NP_GW command described in this manual, which 
explains types of CDCNET titles. 

Format ADD_NP_GW_OUTCALL 

TITLE = any 
NP_APPLICATION_NAME = string 1..7 

GATEWAY J^AME = name 

Parameters TITLE (T) 

Title CDNA applications use to access a NOS application through this 
gateway. The title supports calls from CDNA systems to the NOS host. 
The title must be unique to the gateway (including titles specified on 
DEFINE _NP_GW). The title can be of type name (up to 31 characters), or 
type string (up to 255 characters, within apostrophes). 

NP_APPLICATION_NAME (NAN) 

NOS application name accessed when a CDNA application (or gateway) 
initiates a call connection with the corresponding CDNA title. 

GATEWAY JJAME (GN) 

NP gateway name (see DEFINE _NP_GW command described in this 
manual) providing access to the NOS application. The gateway must be 
previously defined. If this command is specified in a configuration file, 
default is the previously defined NP gateway name. 

If this command is entered by the network operator through the Network 
Operator Utility (NETOU), this parameter is required. 

Responses NP gateway title < title > added. 

-ERROR- Title < title > already defined. 

-ERROR- NP gateway <name> not defined. 

-ERROR- No NP gateway defined. 

-ERROR- < title > must be string or name type. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples add_np_gw_outcall t1tle='PTFS$M80' .. 
np.app 1 1 cat 1 on_name= ' RTFS ' 

NP gateway title PTFS$M80 added. 
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ADD .OUTGOING .SERVICE .ACCESS (ADDOSA) 
DI Configuration/NETOU Command 

Purpose Adds the titles of servers that may be accessed going out via the network 
solution. 

Format ADD_OUTGOING .SERVICE _ACCESS 

TITLE = list 1..15 of name or string 1..255 

NETWORK J^AME = name 

Parameters TITLE (T) 

Title of a server that may be accessed going out via the network solution. 
The title may contain wildcard characters to specify a set of allowed titles 
(see the CDCNET Network Operations and Analysis manual for 
information on wildcard characters). 

Title is case-sensitive when entered as a string. For example, if the 
command defining a service specifies the service title in uppercase, it must 
be specified in uppercase for the ADDOSA command or it is seen as a 
different title. 

For more information on the use of service titles, see the CDCNET 
Configuration manual. 

NETWORK _NAME (NN) 

Identifies the name of a currently defined network within this system. This 
is the network solution upon which the offered services are being defined. 
Defaults to the previously defined network when on the configuration file. 
This parameter is required when the command is entered by the operator. 

Responses Outgoing service access added to network < network _name>. 

-WARNING— Outgoing service access added to network < network _ 

name>. 

Title < title > already added to network. 

{Line repeats for each title already added to network} 

—ERROR- A network is not defined. 

—ERROR— Network < network _name> is not defined. 

-ERROR- Title < title > may not appear more than once in the list of 
specified titles. 

-ERROR- Expecting NAME or STRING, found <xxx>. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Examples In this example, an HDLC trunk links two separate sites (figure 3-4). 

Assume that service access between the two sites must be limited to the 
following: 

• QTF/PTF file transfers in either direction. 

• Site 1 has unrestricted interactive service access to site 2. 

• Site 2 interactive service access to site 1 is limited to Host_l. 
Add the following to the configuration file for NDI_21. 

def1ne_hdlc_net.. 

trunk_name»hdlc_trunk_1 ,network_name»hdlc_net_1 , . . 
network_td=3.. 

i ncomi ng_servi ce_access=( f 1 1 e_t ransf er , 1 nteract 1 ve) . . 
outgo1ng_service_access=(f ile_transfer) 
add_outgoing_service_access tit le=host_1 

The DEFINE _HDLC_NET command prevents interactive attempts from 
going out on the network, thus eliminating extra traffic. 

The ADD_OUTGOING_SERVICE .ACCESS command allows access to 
HOST_l. 
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Figure 3-4. ADDOSA Example 
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ADD_RIP_SERVICE (ADDRS) 

DI Configuration Command/NETOU Command 

Purpose Adds Routing Information Protocol (MP) support on directly connected IP 
networks/subnets. When RIP is configured, CDCNET receives and/or sends 
RIP datagrams over the network. The RIP datagrams received are used to 
update the routing information in the DI for routing IP datagrams. When 
processing received datagrams, RIP does not change existing route table 
entries for statically configured routes (for example, owner = IPSR) or for 
routes owned by EGP or ICMP. 

The RIP datagrams sent contain routing information that other RIP hosts 
on the network can use to route IP datagrams through the DI. RIP 
datagrams are sent when requested by a RIP peer, either periodically 
(every 30 seconds) on all directly connected networks with RIP configured, 
or when an update received from a gateway on one network is relayed to 
other directly connected networks. 

RIP processes default routes (IP address = 0.0.0.0). RIP does not change a 
statically configured default route. RIP sends a known default route, unless 
excluded using the EXCLUDED_ROUTES parameter. 

The User Data Protocol (UDP) must be configured by the DEFINE _UDP_ 
INTERFACE command before the RIP service is configured. IP broadcast 
must also be enabled on the IP network for which RIP service is added. 
Use the ENABLE _IP_BROADCAST parameter on the DEFINE _IP_NET 
command. 

Format ADD_RIP_SERVICE 

IP_NETWORK = list 1..4 of 0..255 
OPERATING _MODE = keyword value 
TRUNK JCOST = integer 1..15 

TRUSTED JVEIGHBORS = list 1..5 of list 1..4 of 0.. 255 
EXCLUDED _ROUTES = list 1.20 of list 1..4 of 0..255 
INCLUDED _JlOUTES = list 1..20 of list 1..4 of 0..255 
DISABLE _ARP_ROUTING = boolean 
POISONED_REVERSE = boolean 

Parameters IP_NETWORK (IN) 

Specifies the IP network number of the directly connected network for 
which the RIP protocol is to be used. This network must have been defined 
by a DEFINE _IP_NET command, 

OPERATING _Jd ODE (OM) 

Specifies how RIP is used on this directly connected network. This 
parameter deals with the processing of RIP update messages and not the 
processing of RIP request messages. CDCNET responds to ail RIP request 
messages. The default is BOTH. 
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The possible keyword values are: 
Keyword Value Description 



BOTH RIP update messages should be sent on this 

network. Received RIP update messages should be 
processed. 

RECEIVE RIP update messages should be sent on this network 

only when the update is requested from a peer. 
Received RIP update messages should be processed. 

SEND RIP update messages should be sent on this 

network. Received RIP update messages should not 
be processed. 

TRUNKJCOST (TC) 

Specifies the RIP cost for this directly connected network. A RIP update 
message received from a peer contains a cost value for each network 
reported. The reported cost is incremented by this parameter value prior to 
creating or updating the IP routing table information for the reported 
network. The cost, which is stored in IP routing table entries created by 
RIP, is the same as the HOP_COUNT value for routing table entries 
statically configured by the DEFINE _IP_NET command. With RIP, a 
network whose cost equals 16 (or greater) is considered unreachable. This 
parameter is meaningful only if the OPERATING _MODE parameter is 
BOTH or RECEIVE. The default is 1. You can use a value other than 1 to 
show preference between directly connected networks that both provide 
routes to the same remote network. 

TRUSTED^NEIGHBORS (TN) 

Specifies a list of IP addresses for neighbor hosts from which incoming RIP 
updates are considered valid. Only updates from these neighbors are 
candidates for inclusion in the local IP routing tables. This parameter is 
meaningful only if the OPERATING _MODE parameter is BOTH or 
RECEIVE. The default is ALL. 

EXCLUDED ^ROUTES (ER) 

Specifies a list of IP network numbers not to be included in RIP update 
messages sent on this directly connected network. This parameter is 
meaningful only if the OPERATING _MODE parameter is BOTH or SEND. 
The default is NONE. 

INCLUDED _ROUTES (IR) 

Specifies a list of IP network numbers to be included in RIP update 
messages sent on this directly connected network. This parameter is 
meaningful only if the OPERATING _MODE parameter is BOTH or SEND. 
The default is ALL. 

DISABLE _jARP_ROUTING (DAR) 

Specifies whether ARP proxy routing should be disabled or remain enabled 
on the network. A value of TRUE indicates ARP proxy routing is to be 
disabled; FALSE indicates it should remain enabled. The default is TRUE. 
This parameter should be TRUE unless situations call for both RIP and 
ARP proxy routing to be enabled. 
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POISONED_JlEVERSE (PR) 

Specifies whether to use split horizon with poisoned reverse routing or 
simple split horizon routing when issuing network information back to the 
network that the data was received from. A value of TRUE indicates split 
horizon with poisoned reverse when network information is issued with an 
infinite metric. A value of FALSE indicates simple split horizon when 
network information is not issued on these networks. The default is TRUE. 

Responses RIP service is added for IP network/subnet <ip_network>. 

-ERROR- UDP is not defined. 

-ERROR- RIP service is already defined for IP network/subnet <ip_ 
network >. 

-ERROR- IP broadcast is not enabled for the specified IP network. 

-ERROR- IP network <ip_network> is invalid. 

-ERROR- IP network <ip_network> is not defined. 

-ERROR- IP subnet <ip .network > is invalid. 

-ERROR- IP subnet <ip_network> is not defined. 

-ERROR- IP network <ip .network > is not directly connected. 

-ERROR- IP address < trusted .neighbor > is not a host on this directly 
connected network. 

-ERROR- IP host address < excluded .routes > cannot be specified as an 
excluded route. 

-ERROR- IP host address < included .routes > cannot be specified as an 
included route. 

-FATAL— Not enough memory is currently available for required table 
space. 

Remarks RIP service does not recognize RIP update messages for a default route. 
The user must configure the DEFAULT ROUTE entries in the DI. 
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ADD_SNMP_COMMUNITY (ADDSC) 

DI Configuration Command/NETOU Command 

Purpose Adds support for an SNMP community. 

Format ADD_SNMP_COMMUNITY 

COMMUNITY = string 1..32 
IP_M>DRESS = list 1..4 of 0.255 
SENDJTRAPS = boolean 
ACCESS _MODE = keyword value 

Parameters COMMUNITY (C) 

Specifies the community name for which to add support. The SNMP agent 
uses the list of supported community names upon receipt of a PDU in its 
trivial authentication scheme. 

IP_ADDRESS (IA) 

Specifies the IP address associated with the input community name. If 
there are no IP addresses associated with a particular community name, 
all IP addresses are accepted, hut no traps are sent to those IP addresses. 
If there are IP addresses associated with a community name, only PDUs 
from the IP addresses with that community name are deemed authentic. 
Traps are sent only to IP addresses tconfigured with the SEND_TRAPS 
parameter set to TRUE. The SNMP Agent allows PDUs from any IP 
address that has a community name of public and READ_ONLY access. 

SENDJTRAPS (ST) 

Specifies whether the input IP_ADDRESS/COMMUNITY pair should be 
sent SNMP Agent Traps. If TRUE, the SNMP Agent generates and sends a 
cold start trap to the defined IP address and community. 

ACCESS .MODE (AM) 

Specifies the access mode the IP_ADDRESS/COMMUNITY pair is allowed. 
If READ-ONLY, you cannot set any variables. If READ_WRITE, you can 
set nonsensitive variables in MIB-II to READ_WRITE access. You cannot 
set sensitive variables, such as variables in the IP Routing Table. The 
default is READ-ONLY. 
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I Responses The SNMP community '< community >' has been added. 

| IP address <ip address > for SNMP community '< community >' has been 

| added. 

I -ERROR- The SNMP Agent is not defined. 

| 

| -ERROR- The SNMP community '< community >' has already been 

1 defined. 

% 

| -ERROR- IP address <ip .address > for SNMP community 

| '< community >' has already been defined. 



-ERROR- IP^ADDRESS is a required parameter if SENDJTRAPS is 
specified as TRUE. 

-FATAL- Not enough memory is currently available for required table 
space. 
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ADD_TCPIP_ACCESS (ADDTA) (NOS/VE Only) 
DI Configuration Command/NETOU Command 



Purpose 



Adds TCP/IP services to a previously defined NOS/VE interface which 
allows access to TCP/IP applications on a NOS/VE host. 

NOTE 



For NOS applications, use the DEFINE _TCPIP_GW command described in 
this manual. 



Format 



ADD_TCPIP_ACCESS 

IP_ADDRESS = list 4 of 0..255 

INTERFACE _NAME = name 
MAX_LISTEN_J>ORTS = integer 1..10 



Parameters 



IP_ADDRESS (IA) 

Specifies the IP address of the NOS/VE CYBER host for which this access 
provides service. This IP address must have been previously defined by a 
DEFINE _IP_HOST command. The format of this parameter is similar to 
the decimal octet convention used by the TCP/IP community, except that 
the periods are replaced by commas, and the list is enclosed in 
parentheses. For example, the IP address 128.2.53.7 would be represented 
as (128,2,53,7). 

INTERFACE J^AME (IN) 

Specifies the logical name of the NOS/VE interface to be used for TCP/IP 
access. Before executing this command, the NOS/VE interface must be 
configured, either explicitly by using the DEFINE _VE _INTEREA.CE 
command or implicitly by booting the DI system over the channel running 
the NOS/VE interface. 

This parameter is required if more than one MCI board exists in the DI. 

MAX LISTEN JPORTS (MLP) 

Specifies the maximum number of listen sockets allowed per port when an 
application from NOS/VE opens a TCP SAP. The lesser of two values, the 
one specified by the TCP/IP application on the open SAP call and the other 
the value of this parameter, is used. The default is 5. 

Responses TCP/IP access is added for VE interface < interface _name>. 

-WARNING- TCP/IP access is already added for VE interface < interface. 
name>. 

-ERROR- No VE interface is defined. 

-ERROR- VE interface < interface _name> is not defined. 

-ERROR- Interface < interface _name> is not a VE channel interface. 

-ERROR- IP address <ip_address> is invalid. 

-ERROR- IP host address <ip_address> is not defined. 
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-ERROR- IP host with address <ip_address> must be of host type 
LOCAL or CDC_HOST. 

-ERROR- The Device Interface contains more than one CHANNEL board 
the interface _name must be specified. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Examples The first example uses a host with only one channel to a DI. 

I NOS/VE I 

I HOST | <-ip_host address = 129.179.60.1 

I 

l <-1nterface name ■ nos_ve_1 

I C180 I 

I MDI | <-md board 1n slot 4 

I I 

I 
/ / 

The following supporting configuration commands are used for the MDI. 

define_ve_interface interface_slot=4 1nterface_nanie=nos_ve_1 
define_ip_net 1p_network=( 129, 179,60) trunk_name=nos_ve_1 .. 

subnet _mask_s1 ze=22 
define_tcp_interface 
def i ne_udp_1 nter f ace 

def1ne_ip_host ip_address=( 129, 179,60,1) host _type= local 
add_t cp i p_access 1 p_addr ess= ( 1 29 , 1 79 , 60 , 1 ) 

Inter f ace_name=nos_ve_ 1 

The second example uses a host with two channels to two DIs. 



I NOS/VE I 

ia = 129.179.60.1 -> | HOST | <-1a = 129.179.60.2 

*_________ * 

In = nos_ve_l -> | | <-ln = nos_ve_2 

nl = 0014(16) -> | | <-n1 = 0015(16) 

I C180 | I C180 I 

mcl In slot 4 -> | MDI | | MDI | <-md In slot 4 

I 1 I I 2 | 

'_______' '_______/ 



I I 
/ / 



The following supporting configuration commands are used for MDI 1. 

defvl 1nterface_slot»4 1nterface_name=nos_ve_1 .. 

network_1d=0014(16) 
def1ne_1p_net 1p_network=( 129, 179,60) trunk_name=nos_ve_1 

subnet _mask_s1 ze=22 
def 1 ne_t cp_ 1 nt er face 
def 1ne_udp_l nter face 

def1ne_1p_host 1p_address«( 129, 179,60,1) host _type- local 
add_t cp 1 p.access 1 p_addr ess- ( 1 29 , 1 79 , 60 , 1 ) . . 

1 nt er f ace_name=nos_ve_ 1 
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The following supporting configuration commands are used for MDI 2. 

defvl 1nterface_slot=4 1 nterf ace_name=nos_ve_2 .. 

network_ld=00l5(l6) 
def1ne_1p_net 1p_network=( 129, 179,60) trunk_name»nos_ve_2 .. 

subnet_mask_s 1 ze=22 
define_tcp_1nterface 
def 1 ne_udp_1 nterf ace 

def 1 ne_i pjiost 1 p_address= ( 1 29 , 1 79 , 60 , 2 ) host_type= 1 oca 1 
add_tcp1p_access ip_address=( 129, 179,60,2) .. 

1 nt er f ace_name=nos_ve_2 

The third example shows two hosts with one channel each to the same DI. 



ia = 129.179.60.1 -> | NOS/VE | | NOS/VE | <-1a = 129.179.60.2 
I HOST | | HOST | 

in ■ nos_ve_1 -> I | <-in = nos_ve_2 

ni = 0014(16) -> | | <-n1 = 0015(16) 

mci In slot 6 -> I C180 I <-md In slot 7 
I MDI | 
I 1 I 



I 



The following supporting configuration commands are used for the MDI. 

defvl 1nterface_slot=6 1 nterf ace_name=nos_ve_1 .. 

net work_1d=00 14(16) 
defvl 1nterface_slot=7 interface_name=nos_ve_2 .. 

net work_id=00 15(16) 
define_1p_net 1p_network»(129, 179,60) trunk_name=nos_ve_1 .. 

subnet _mask_s1 ze=22 
def1ne_tcp_1 nterf ace 
def 1 ne_udp_ 1 nt er face 

def1ne_ip_host 1p_address=( 129, 179,60,1) host_type=local 
def1ne_1p_host ip_address=( 129, 179,60,2) host_type=cdc_host 
add_t cp 1 p_access 1 p_addr ess= ( 1 29 , 1 79 , 60 , 1 ) 

1 nterf ace_name=nos_ve_ 1 
add_tcp1p_access 1p_address=(129, 179,60,2) .. 

1 nterf ace_name=nos_ve_2 
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ADD JTELNET_SERVER (ADDTS) 

DI Configuration Procedure/NETOU Command 

Purpose Configures an instance of the TELNET Server into the DI. Each instance 

of a TELNET Server is associated with a unique IP address and PORT 
number. Multiple TELNET Servers can be configured into a DI. 

The command DEFINE _TIP TN=TELNETTIP is used to configure the 
TELNET TIP into the DI and must be executed before any ADD_ 
TELNETJSERVER commands. The DEFINE _TIP command is also used to 
establish the default values for some of the parameters of the ADD_ 
TELNET_SERVER command. 

Format ADDJTELNET_SERVER 

SERVER _NAME = name 
IP_ADDRESS = list 4 of 0..255 

TCPJPORT_NUMBER = 0..65535 

PROTOCOL = TELNET or NONE 

TERMINAL DEFINITION ^PROCEDURE = name or none 

TERMINAL _USER PROCEDURE = name or none 

PROCEDURE _FILE JOPTION = IP ^ADDRESS CONCATENATION 

or none 
CONNECTION CONNECT JTIMEOUT = 20..1000 or INFINITE 
CONNECTION DISCONNECT JTIMEOUT = 0..1000 or INFINITE 
USER CONNECTION JAMIT = 1..16 
INITIAL JOPTION _NEGOTIATION = list 1..4 of keyword 
VALIDATE JUSERS = boolean 
TCP JTIMEOUT = 0.. 65535 or INFINITE 

Parameters SERVER _NAME (SN) 

Logical name of the specified TELNET Server. This name is used in 
subsequent commands that reference this TELNET Server. It also specifies 
the line name for other terminal support commands such as WRITM. 

IP.ADDRESS (IA) 

IP address associated with this TELNET Server. The format is similar to 
the decimal octet convention used by the TCP/IP community, except that 
the periods are replaced with commas, and the list is enclosed in 
parentheses. For example, IP address 128.2.53.7 is specified as (128,2,53,7). 

TCP_PORT_NUMBER (TPN) 

TCP port number associated with this TELNET Server. Default is 23 
which is the standard value. 

PROTOCOL (P) 

Specifies the protocol used on the TCP connection. TELNET specifies that 
TELNET protocol is used. For incoming terminal connections, select 
TELNET. If lined is to be used on a UNIX system to connect to this 
server for access to a CDCNET printer, select NONE. NONE specifies that 
no protocol above TCP is used. Default is TELNET. 
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TERMINAL DEFINITION PROCEDURE (TDP) 

Specifies the TDP automatically executed for all users when they first 
access this TELNET Server. NONE specifies that no TDP is to be 
automatically executed. The default value for this parameter is derived 
from the value of the DEFINE _TIP command parameter with the same 
name. 

TERMINAL JUSER JPROCEDURE (TUP) 

Specifies the TUP automatically executed for all users when they first 
access this TELNET Server. NONE specifies that no TUP is to be 
automatically executed. This parameter can be used only when the TDP 
parameter has a value of NONE. The default value for this parameter is 
derived from the value of the DEFINE _TIP command parameter with the 
same name. 

PROCEDURE _FILE JOPTION (PFO) 

Specifies one of two options for qualifying the procedure name specified by 
either the TDP or TUP parameter. Specifying IP_ADDRESS_ 
CONCATENATION causes the remote IP address identified within the 
incoming connection to be concatenated with the name specified by either 
the TDP or TUP in effect for this Server. If neither a TDP nor TUP is in 
effect for this Server, this parameter is ignored. NONE selects no 
concatenation. Default is NONE. 

CONNECTION JCONNECTJTIMEOUT (CCT) 

Defines how much time the TELNET user has to create the first 
$input/$output connection. If no connection is established within that time, 
the TELNET connection is terminated. It may be necessary to increase this 
value if the VALIDATE .USERS parameter is TRUE. INFINITE indicates 
an infinite time. The timer has a precision of +/- 2 seconds. Default is 
120. 

CONNECTION DISCONNECT JTIMEOUT (CDT) 

Defines how much time the TELNET user has to establish a new 
$input/$output connection after the last such connection has been 
disconnected. If no new connection is established within that time, the 
user's connection terminates. INFINITE indicates an infinite time. Default 
is 120. 

USER CONNECTION _LIMIT (UCL) 

Defines the maximum number of interactive $input/$output connections 
allowed at any one time by a TELNET user. Default is 4. 

INITIAL JOPTION .NEGOTIATION (ION) 

Specifies the set of TELNET options to be negotiated (transmitted) by this 
TELNET Server during the initial startup of all TELNET connections. You 
may specify any subset of the keywords, WILL_SGA, WILL JECHO, DO_ 
SGA, and DO.TTYPE or the single keyword NONE. A list containing the 
keyword NONE is treated as if NONE were the only keyword specified. 
The keyword NONE specifies that no TELNET option negotiation is to be 
initiated by this TELNET Server. This parameter is ignored when the 
PROTOCOL parameter has a value of NONE. Default is (WILL SGA, 
WILL_ECHO). 
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Keyword Value 



Description 



DO_SGA 
DO.TTYPE 

WILL_ECHO 
WILL_SGA 

NONE 



The server asks the client to suppress the Go Ahead 
option. 

The server asks the client to negotiate terminal 
type. The received terminal type is used as the 
TERMINAL_MODEL terminal attribute. 

The server offers to do character echoing. 

The server offers to suppress the Go Ahead option. 

The server negotiates no TELNET options. 

VALIDATE _USERS (VU) 

Specifies if the TELNET users accessing this TELNET Server are validated 
when user validation is enabled by the DEFINE JUSER .VALIDATION 
command. If VU is TRUE, users are validated when validation is enabled. 
The default value for this parameter is derived from the value of the 
DEFINE _TIP command parameter with the same name. 

TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of data transmission. If an acknowledgment is not received 
within the specified period, TCP aborts the connection. Entering a small 
value (less than a few seconds) may cause frequent and unnecessary loss of 
service during periods of network congestion. Entering a large value may 
cause users to wait a long time after the host or network has failed. If you 
enter INFINITE, the connection will not time out. The default value is 300 
seconds. 

The TELNET TIP uses this parameter to determine how often to send 
TELNET NOP commands on inactive connections, ensuring the connection 
aborts if the remote host is no longer available. 

Responses TELNET server < server _name> is added. 

--ERROR- The TELNET TIP must be defined prior to adding TELNET 
servers. 

-ERROR- TELNET server < server _name> is already added. 

-ERROR- IP address <ip_address> is not defined. 

-ERROR- IP address and port <ip_address.port> is already in use. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples add_telnet_server server_name=arhnet 1p_address=(128,2,53,7) 
TELNET server ARHNET 1s added. 
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ADD_X25_GW_INCALL (ADDXGI) 

DI Configuration Procedure/NETOU Command 

Purpose Defines calling DTE addresses that can access CDCNET and titles to which 
they may connect. A title can be a NOS/VE application title, a Network 
Products (NP) gateway title, or an X.25 A-to-A gateway title. The first 
time a DTE address is specified on ADDXGI, an entry is made in a list of 
incall validations the gateway performs. If a DTE address is specified that 
has been specified previously, an error results. 

Format ADD_X25 _GW_INCALL 

REMOTE _DTE ..ADDRESSES = (list 1..31 of string 1..15) or 
OTHER 

GATEWAY JIAME = name 

ALLOWED JTITLES = list 1..31 of (list 1.2 of (string or name or 
keyword value) or boolean) 

Parameters REMOTE JDTE ..ADDRESSES (RDA) 

One or more allowed DTE addresses. When the X.25 call is received, and 
the calling DTE address is not in the list of DTE addresses of any 
ADDXGI command, the call is cleared. OTHER indicates any DTE address 
not specifically listed in any other INCALL command for the gateway. 

GATEWAY J^AME (GN) 

Name of the X.25 A-to-A gateway receiving incoming calls to be validated. 
The gateway must be previously defined. This parameter value depends on 
how ADDXGI executes. 

If ADDXGI executes in a configuration procedure, this parameter is 
optional, and the default network name is the previously defined X.25 
gateway. 

If ADDXGI is entered by a network operator, this parameter is required. 

ALLOWED JTITLES (AT) 

List of titles the caller can access, and, for each title, whether the caller 
can use reverse charging. Titles can contain wildcard characters to specify 
a set of allowed titles. The following rules apply to titles and wildcard 
characters specified on ADDXGI: 

• If ALL, the * wildcard character, or no titles are specified, calls to any 
title are accepted. 

• If a title or pattern is specified more than once, an error results. 

• If an incoming title matches more than one allowed title pattern, the 
first pattern that is matched is used. 

The following keyword values on ALLOWED_TITLES specify whether or 
not the caller can use reverse charging: 
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Keyword Value 



Description 



YES 



Service can be accessed with reverse charging 
(reverse charging is accepted). 

Calls with reverse charging are not accepted. 



NO 

Default is NO. 

Responses X.25 incall added to gateway < gateway _name>. 

-ERROR- An X.25 gateway is not defined. 

-ERROR- X.25 gateway <name> is not defined. 

-ERROR— Remote _dte_address can not include < string >. A remote _dte_ 
address may include only digits thru 9. 

-ERROR— Address < string > is already specified as a remote _dte_ 
address. 

-ERROR- Title < string > is already specified as an allowed _title. 

-FATAL— Not enough memory is available for required table space. 

Examples The following example specifies that gateway X25GW accepts all incoming 
calls accepted with reverse charging requested. 

add_x25_gw_1ncal 1 gateway_name=X25GW, . . 

remote_dte_address=OTHER, al1owed_t1tles = (ALL, YES) 

The following example specifies that incoming calls from DTE addresses 
408123, 408456, and 612789 to gateway X25GW can connect to any title 
beginning with 'PTFS$'. Calls with reverse charging specified are not 
allowed. 

add_x25_gw_1ncal 1 gateway_name-X25GW, . . 

remote_dte_addresses=( '408123' , '408456' , '612789' ) , . . 
a 1 1 owed_t 1 1 1 es« ' PTFS$ * ' 

The following example specifies that gateway X25GW accepts only 
incoming calls from DTE addresses 4081234, 4083456, and 6126789 and 
requesting titles beginning with PTFS$ and QTFS$ using reverse charging. 
Calls from all other DTE addresses can connect to PTFS$PUBLIC and 
QTFS$PUBLIC, without reverse charging. 

add_x25_gw_1nca1 1 gateway_name=X25GW, . . 

remote_dte_addresses=( '4081234', '4083456', '6126789' ),. . 
allowed_t1tles»(('PTFS$»',YES), CQTFS$*',YES)) 

add_x25_gw_1nca1 1 gateway_name=X25GW, . . 
remote_dte_addresses*OTHER, . . 
al1owed_t1tles«(('PTFS$PUBLIC'),('QTFS$PUBLIC')) 
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ADD_X25_GW_OUTCALL (ADDXGO) 

DI Configuration Procedure/NETOU Command 

Purpose Defines a gateway outcall definition. Outcall is from the perspective of the 
CDCNET network; that is, the call goes out of CDCNET. Outcall 
information generates the proper call request into the X.25 network. An 
X.25 gateway outcall consists of a CDNA title, outcall addressing, and 
connection parameters associated with an X.25 gateway. NOS/VE 
applications or other gateways translate on this type of title to make direct 
outgoing calls on X.25 without the application specifying X.25 addressing. 
See also the DEFINE _X25_GW command description in this manual. 

Format ADD _X25 _GW_OUTCALL 

TITLE = string 1..255 
REMOTE _DTE ..ADDRESS = string 1..15 
PROTOCOL _ID = 0..255 

GATEWAY_NAME = name 
LOCAL _DTE_ADDRESS = string 1..15 
FACILITIES = string 1..63 
USER_DATA = string 2.248 

Parameters TITLE (T) 

Title CDNA applications use to access a particular remote application 
through this gateway. The title supports calls from CDNA systems to 
remote systems accessed through the X.25 network. 

REMOTE _DTE_ADDRESS (RDA) 

X.25 address of the destination X.25 system, specified as a string of digits 
through 9. 

PROTOCOL _ID (PI) 

Protocol identifier required by the destination X.25 system. This value is 
placed in the first octet of the protocol identifier field within the call user 
data in a call request. Octets 2 through the protocol identifier field are set 
to by the gateway. 

GATEWAY JiAME (GN) 

Name of the X.25 gateway providing access to the remote application. The 
gateway must be previously defined. If this command is specified in a 
configuration file, default is the previously defined X.25 gateway name. 

If this command is entered by the network operator through the Network 
Operator Utility (NETOU), this parameter is required. 

LOCAL JDTE _ADDRESS (LDA) 

X.25 address of a local X.25 trunk, specified as a string of digits with 
values from through 9. The call request is attempted over the X.25 
trunk with the matching DTE address. The call is rejected if no matching 
trunk is found. Default is that the X.25 Packet Level selects a trunk to 
make the call request. 
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FACILITIES (F) 

Facilities options as defined by the X.25 CCITT standard. For information 
on X.25 facilities options, see CCITT Recommendation X.25. Specify this 
parameter as an even-numbered string of hexadecimal digits. 

USER jy ATA (UD) 

An even-numbered string of hexadecimal digits. This value is put at the 
beginning of any "real" user data from the session indication, and the 
concatenated string is then put into the USER_DATA field of the X.25 
call. The call is rejected if the concatenated string exceeds the field size. 
The maximum field size is 124 octets with the fast select facility, and 12 
octets without the fast select facility. 

Responses X.25 gateway title < title > added. 

-ERROR- An X.25 gateway is not defined. 

-ERROR- Remote _dte_address can not include < string >. A remote _dte_ 
address may include only digits through 9. 

-ERROR— Local _dte_address can not include < string >. A local _dte_ 
address may include only digits through 9. 

-ERROR- Facilities can not include < string >. Facilities may include only 
hexadecimal digits thru 9 and a thru f. 

-ERROR- Facilities can only have an even number of hexadecimal digits. 

-ERROR- User_data can not include < string >. User data may include 
only hexadecimal digits thru 9 and a thru f. 

-ERROR- User_data can only have an even number of hexadecimal 
digits. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples The following detailed example shows how the ADDXGO command builds a 
call request. 

add_x25_gw_outcal 1 . . 
title = ptfs$vw .. 
gateway.name ■ x25_gateway . . 
remote_dte_address='31 1061200046' . . 
protoco 1 _ 1 d=0c2 ( 16 ) . . 
fad 1 1t 1es=' 420707430202' 
user_data='50544653245657 ' 

This example sends the following X.25 call request when an application 
calls (connects) to title $PTFS$VW: 

0B 0C 31 10 61 20 00 46 06 42 07 07 43 02 02 . . 
C2 00 00 00 50 54 46 53 24 56 57 



In a binary format, the call request looks like figure 3-5: 
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Figure 3-5. X.25 Call Request Generated by ADDXGO Command 

If no FACILITIES parameter is specified, the facilities length octet is zero: 
OB OC 31 10 61 20 00 46 00 C2 00 00 00 50 54 46 53 24 56 57 

If no USER_DATA parameter is specified, no call data is included: 
OB OC 31 10 61 20 OO 46 00 C2 00 00 00 



If a LOCAL _DTE__ADDRESS parameter is specified, the calling DTE 
address is included: 

OB CC 31 10 61 20 00 46 31 10 40 80 01 46 06 42 07 07 43 02 02 .. 
C2 00 00 00 50 54 46 53 24 56 57 
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ADD_X25_GW_PVC (ADDXGP) 

DI Configuration Procedure/NETOU Command 

Purpose Defines PVCs for the given gateway. The PVCs can be for either incoming 

calls or outgoing calls. When the X.25 gateway receives an outgoing call 
(for example, an application call request), it determines the title based on 
the user data supplied. If this title is associated with a PVC, it establishes 
a PVC connection (for example, an X.25 reset request is sent with CAUSE 
field set to REMOTE DTE OPERATIONAL) and discards any additional 
user data. The application is responsible for initiating the connection to the 
CDCNET DI. Once the application has established a connection, if a reset 
is received with the CAUSE field set to OUT OF ORDER, the connection 
is terminated. To disconnect the PVC, the application must terminate the 
connection. This causes a reset to be sent with the CAUSE field set to 
OUT OF ORDER. Any other resets received with other CAUSE fields 
create a CDCNET session layer SYNCH request to be sent to the 
application. 

Format ADD.X25 _GW_PVC 

TITLE = name 
PERMANENT. VIRTUAL .CIRCUIT = 1..4095 

GATEWAY_NAME = name 
PVC_fACKET_SIZE = 16..4096 
PVC _WINDOW_SIZE = 1..127 
TRUNK_NAME = name 

Parameters TITLE (T) 

Specifies the title that CDCNET applications can use to access a particular 
remote application through this gateway. The title supports calls from 
CDCNET systems to remote systems accessed through the X.25 trunk. 

PERMANENT_VIRTUAL .CIRCUIT (PVC) 

Specifies the permanent virtual circuit with which the given title is 
associated. The value must be within the range of the PVC_RANGE 
parameter defined on the DEFINE _X25 .INTERFACE command. Its value 
cannot overlap another defined PVC (for example, X25_ASYNCTIP or a 
PVC given on a previously defined ADD_X25_GW_PVC). 

GATEWAY JJAME (GN) 

Specifies the name of the X.25 gateway that provides access to the remote 
application. The gateway must be previously defined. Default is the 
previously defined X.25 gateway when included in the configuration file. 
This parameter is required when entered by an operator. 

PVCJPACKETJSIZE (PPS) 

Specifies the default packet size to be used for this PVC. The default is 
the value specified on the DEFAULT.PACKET.SIZE parameter of the 
associated DEFINE _X25 .INTERFACE command. See the description of the 
DEFINE _X25 .INTERFACE command for allowed values. 

PVCJWINDOWJSIZE (PWS) 

Specifies the default window size to be used for this PVC. The default is 
the value specified on the DEFAULT.WINDOW.SIZE parameter of the 
associated DEFINE _X25 .INTERFACE command. 
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TRUNK_JtfAME (TN) 

Specifies the trunk to be used for this PVC. This parameter is required if 
a list of trunk names was specified on the DEFINI ...X25_GW command. If 
only one trunk name was specified on DEFINE _X1„,_GW, that is the 
default trunk and this parameter is not required. 

Responses PVC <pvc> added for title <title>, X.25 gateway <gn>. 

-ERROR- An X.25 gateway is not defined. 

-ERROR- X.25 gateway < gateway _name> is not defined. 

-ERROR- X.25 gateway title <title> already defined. 

-ERROR- PVC packet size <pps> is not a valid X.25 packet size. 

-ERROR- PVC window size <pws> is greater than 7 and the DEFINE _ 
X25 .INTERFACE PSN parameter is NORMAL for trunk <trunk_name>. 

-ERROR- Permanent Virtual Circuit number <pvc> is not defined on 
DEFINE _X25 .INTERFACE, PR parameter. 

-ERROR- Permanent Virtual Circuit number <pvc> is already assigned 
by another X.25 user. 

-ERROR- Trunk name < trunk _name> not defined as an X.25 trunk on 
the X.25 gateway < gateway _namc>. 

-ERROR- More than one trunk _name associated with X.25 gateway 
< gateway _name>. Trunk .name must be specified. 

-ERROR- Permanent Virtual Circuit number <pvc> is already assigned 
to title <title>, X.25 gateway < gateway _name>. 

-ERROR- X.25 Gateway command failed due to title processor error. 

-FATAL- Not enough memory available for required table space. 

Examples The following example associates a permanent virtual circuit of 100 to title 
PVC$FRN. 

add_x25_gw_pvc gateway_name=X25_GW t 1 t 1 e=PVC$FRN .. 
permanent_virtual_c1rcult=100 

PVC 100 added for title PVC$FRN, X.25 gateway X25_GW 
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ADD_X25_INCALL (ADDXI) 

DI Configuration Procedure/NETOU Command 

Purpose Defines a general purpose X.25 incall definition. An incall definition is 

from the perspective of the CDCNET network. The incall information is 
used by the X.25 packet-level entity to control X.25 calls coming into the 
CDCNET network destined for any X.25 user. 

A trunk that has no X.25 incall definition does not validate incoming X.25 
calls. This is the default situation. Each trunk is handled independently. 
The means for associating the incoming call with the incall definition is 
the combination of the remote DTE address (calling DTE address) and the 
protocol identifier. 

In general, the validation configured by ADD_X25_INCALL is independent 
of the validation configured by any X.25 users. Most X.25 users do not 
have their own incall validation. However, the X.25 gateway does, as 
defined by ADD_X25 _GW_INCALL. Incoming calls destined for the X.25 
gateway are subject to validation by the X.25 packet level as well as the 
X.25 gateway. 

Format ADD_X25 _INCALL 

TRUNK _NAME = list 1..32 of name 

REMOTE _DTE .ADDRESSES = list 1..31 of string 1..31 or 
keyword value 

DTE .ADDRESS JPROTOCOL JD = list 1..7 of 0..255 or keyword 

value 
ACCEPT _PDN_CHARGES = boolean 

Parameters TRUNK .NAME (TN) 

Specifies the logical names of one or more X.25 trunks for this incall 
definition. Each trunk must have been defined by a DEFINE _X25_ 
TRUNK or DEFINE _LLC_2_TRUNK command. 

REMOTE _DTE .ADDRESSES (RDA) 

Specifies one or more allowed calling DTE addresses. A DTE address can 
contain wild card attributes (to associate the incall definition with multiple 
DTE addresses) as follows: 

[D1-D2] Within a bracketed group, a range of digits can be specified. Dl 
represents the low end of the range; D2 represents the high end. 
Any value within the range can be used to match a digit in the 
position specified in the address. For example, 1234[6-7]59 
matches two DTE addresses: 1234659 and 1234759. 

[...] Within a bracketed group, any list of single digits can be 

specified. For example, 1234[179]59 matches three DTE 
addresses: 1234159, 1234759, and 1234959. 

* Any single * can be used to match a string of digits, including 

the null string. For example, 1234* matches 1234, 12341, 
1234562345, and so forth. 

? Any single ? can be used to match a digit in the position 

specified in the address. For example, 1234759 matches 10 DTE 
addresses: 1234059, 1234159, 1234259 ... 1234959. 
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If multiple ADD_X25_INCALL definitions exist that match a given DTE 
address, the call definition associated with the most specific string is used. 
For example, 123756 is more specific than 123* in matching calling DTE 
address 123456. 

The keyword OTHER is used to define an incall definition for any DTE 
addresses that do not match any other incall definitions for a given trunk. 
Multiple incall definitions can exist with a REMOTE _DTE .ADDRESSES 
value of OTHER (as well as any other value) as long as the DTE_ 
ADDRESS .PROTOCOL _ID values do not overlap. 

DTE _JJ)DRESS PROTOCOL JD (DAPI) 

Specifies one or more protocol identifiers to identify X.25 users associated 
with the incall definition. The protocol identifier is the first octet of user 
data in an X.25 call packet. This parameter may be either explicit protocol 
identifiers or one of the keywords NULL, ANY, or NONE. 

Keyword Value Description 

NULL Value corresponding to incoming calls without user 

data. 

ANY Any value of the protocol identifier (including 

NULL) is accepted. 

NONE No value of the protocol identifier (including NULL) 

is accepted. 

The default is ANY. 

ACCEPT _PDN JCHARGES (APC) 

Specifies how incoming calls are to be handled. If TRUE, a call is accepted 
with either normal or reverse charging. If FALSE, a call is accepted only 
with normal charging. The default is FALSE. 

Responses The X.25 incall definition(s) have been added. 

-ERROR- The X.25 incall definition for trunk < trunk _name> is already 
defined as follows: 

Remote DTE Addresses = < remote _dte .address > 
DTE Address Protocol Id = <dte_address .protocol _id> 
Accept PDN charges = < accept _pdn .charges > 

-ERROR- Trunk name < trunk _name> is not defined. 

-ERROR- Trunk name < trunk _name> is not an X.25 trunk. 

—ERROR— Trunk name < trunk _name> may not appear more than once 
in the list of specified trunks. 

—ERROR- Remote DTE address < remote _dte_address> may not appear 
more than once in the list of specified remote DTE addresses. 

-ERROR- The remote DTE address < remote _dte .address > contains 
invalid characters. 

-ERROR- The remote DTE address < remote _dte .address > has an 
invalid bracketed expression. 
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-ERROR- DTE address protocol id <dte_address_protocol_id> may not 
appear more than once in the list of specified DTE address protocol ids. 

-FATAL-- Not enough memory available for required table space. 



add_x25_1ncall trunk_name-X25_TRUNK remote_dte_acldresses='123745[5-7]65*' .. 
dte_address_protocl_id=(3,8. . 1H) accept _pdn_charges=TRUE 

The X.2S incall def inition(s) have been added. 

add_x25_incall trunk_name=X25_TRUNK remote_dte_at!dresses=' 123745 [5-7J65*' .. 
dte_address_protocl_1d=(6,22. .32) accept_pdn_charges=FALSE 

The X.25 incall def inition(s) have been added. 

add_x25_incal 1 trunk _name=X25_TRUNK remote_dte_addresses=' 123745 [5-7] 65*' .. 
dte_address_protocl_1d=(3,55. .66) accept_pdn_charges=TRUE 

—ERROR— The X.25 Incall definition for trunk X25.TRUNK Is already defined as follows: 

Remote DTE Addresses 123745 [5-7] 65* 

DTE Address Protocol Id 3 . 8..12 
Accept PDN charges TRUE 

add_x25_incal 1 trunk_name=X25_TRUNK remote.dte.addresses=' 123545 [5-11] 65*' .. 
dte_address_protocl_1d=(3.8. . 12) accept_pdn_charges=TRUE 

—ERROR— The remote DTE address <reniote_dte_address > has an Invalid bracketed expression. 
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ADD _X25 .SWITCH (ADDXS) 

Purpose Defines a general purpose X.25 switch definition. A switch is from the 
perspective of the CDCNET network. The X.25 Gateway uses this switch 
definition to route incoming X.25 calls to another X.25 Gateway within the 
CDCNET network and ultimately out to a PDN or another X.25 trunk. 
This command allows CDCNET to relay between PDNs or other X.25 
trunks with a minimal amount of network administration. The switch is 
transparent: the calling DTE address, facilities, and user data for the 
outgoing side of the switch are the same as on the incoming side of the 
switch. However, if the parameter NEW_CALLED_DTE_ADDRESS is 
specified, the called DTE address in the packet is replaced with the value 
of NEW.CALLED.DTE .ADDRESS. If the parameter NEW_CALLED_ 
DTE_ADDRESS is not specified, no substitution occurs, and the called 
DTE address in the packet remains the same. 

The switch decision is based only on the called DTE address. The switch 
definitions have higher precedence than other X.25 definitions. In other 
words, an incoming X.25 call is initially checked to see if it should be 
switched. If switching is not required, it can be delivered based on a local 
definition. This means it is possible to switch some X.25 AsyncTip traffic 
(forward it to another PDN) while processing other X.25 AsyncTip traffic 
locally. X.25 calls that are switched are subject to validation by the ADD_ 
X25_INCALL command but are not subject to validation by the ADD 
X25_GW_INCALL command. 

CONS traffic can be switched through CDCNET without the use of this 
command by using an ADD_NON_CDC_ROUTING_ENTRY command on 
the outbound side of the switch. However, only user data is transparently 
passed through the switch using this method. 

If the LOCAL _DTE_ADDRESS parameter has been specified on the 
DEFINE _X25 .INTERFACE command for the outbound side of the switch, 
there is no verification for switched calls. Switched calls are sent out on 
the first defined X.25 trunk on the outbound side of the switch. 

Format ADD_X25 .SWITCH 

GATEWAY.NAME = name 

CALLED_DTE .ADDRESSES = list 1..31 of string 1..31 or OTHER 

PEER .VE.OUTCALL. TITLE = name 

NEW jCALLEDJDTE ^ADDRESS = string 1..15 

Parameters GATEWAY.NAME (GN) 

Specifies the name of the X.25 A-to-A Gateway that receives the incoming 
X.25 calls to be switched. The gateway must be previously defined. This 
represents the inbound side of the X.25 switch. 

CALLED.DTE .ADDRESSES (CDA) 

Specifies one or more called DTE addresses. A DTE address can contain 
wild card attributes (to associate the switch definition with multiple DTE 
addresses) as follows: 
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[D1-D2] Within a bracketed group, a range of digits can be specified. Dl 
represents the low end of the range; D2 represents the high end. 
Any value within the range can be used to match a digit in the 
position specified in the address. For example, 1234[6-7]59 
matches two DTE addresses: 1234659 and 1234759. 

[...] Within a bracketed group, any list of single digits can be 

specified. For example, 1234[179]59 matches three DTE 
addresses: 1234159, 1234759, and 1234959. 

* Any single * can be used to match a string of digits, including 

the null string. For example, 1234* matches 1234, 12341, 
1234562345, and so forth. 

7 Any single ? can be used to match a digit in the position 

specified in the address. For example, 1234759 matches 10 DTE 
addresses: 1234059, 1234159, 1234259 ... 1234959. 

If multiple ADD_X25_SWITCH definitions match a given DTE address, 
the call definition associated with the most specific string is used. For 
example, 123756 is more specific than 123* in matching calling DTE 
address 123456. 

The keyword OTHER defines a switch definition for DTE addresses that do 
not match any other switch definitions for a given X.25 gateway. 

PEER_VE_OUTCALL_TITLE (PVOT) 

Specifies a VE_OUTCALL_TITLE registered by the peer X.25 Gateway in 
a DEFINE _X25_GATEWAY command. This represents the outbound side 
of the X.25 switch. 

NEW JCALLEDJDTE ^ADDRESS (NCDA) 

Specifies a DTE address that is substituted for the called DTE address of 
the incoming call packet when this packet is forwarded. No wild card 
character is allowed for this parameter. The default is the original called 
DTE address value. 

Responses The X.25 switch definition(s) have been added. 

-ERROR- The X.25 switch definition for X.25 gateway < gateway _name> 
is already defined as follows: (see the command response example for the 
format in which this information is displayed.) 

-ERROR- An X.25 gateway is not defined. 

—ERROR— X.25 gateway < gateway _name> is not defined. 

—ERROR— Called DTE address < called _dte_address> may not appear 
more than once in the list of specified called DTE addresses. 

-ERROR- The called DTE address < called _dte_address> contains invalid 
characters. 

-ERROR- The called DTE address < called _dte .address > has an invalid 
bracketed expression. 

-ERROR- The new called DTE address may include only digits through 
9. 
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-FATAL- Not enough memory available for required table space. 

Examples add_x25_switch gateway_name=X25_GW_SWTTCH .. 

called_dte_addresses=('123?45[5-7]65*', '23456789' ) .. 
peer_ve_out ca 1 1 _t 1 1 1 e=OUTBOUND_SWITCH 
new_ca 1 1 ed_dt e.addr ess= ' 235567 89 ' 

The X.25 switch deflnltlon(s) have been added. 



add_x25_swltch gateway_name=X25_GW_SWlTCH .. 

called_dte_addresses=('987?45[5-7]65*', '23456789' ) .. 
peer_ve_out ca 11 _t 1 1 1 e=0UTB0UND_SWITCH_2 

—ERROR— The X.25 switch definition for X.25 gateway X25_GW_SWTTCH 
is already defined as follows: 

Called DTE Addresses 23456789 

Peer VE Outcall title OUTBOUND_SWITCH 

New Called DTE Address 23556789 

add_x25_switch gateway_name=X25_GW_SWITCH .. 
cal led_dte_addresses=' 123545[5-11]65*' . . 
peer_ve_out ca 1 1 _t i 1 1 e=OUTB0UND_SWITCH_2 

—ERROR— The called DTE address 123545[5-11]65« has an 
invalid bracketed expression. 
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ADD _X25 .TERMINAL _GW_OUTCALL (ADDXTGO) 
DI Configuration Procedure/NETOU Command 

Purpose Defines a X.25 terminal gateway outcall definition. Outcall is from the 

perspective of the CDCNET network; the call is going out of the CDCNET 
network. It allows the network administrator to configure X.25 outcall 
information and associate it with a logical name (outcall name) to help the 
end terminal user establish foreign connections. Also, the outcall 
information maybe used to restrict access to certain DTE addresses that 
are defined by the network administrator. 

Format ADD _X25 .TERMINAL _GW_OUTC ALL 

OUTCALL _NAME = name 
REMOTE _DTE .ADDRESS = string 1..15 

GATEWAY JVAME = name 
LOCAL _PTE .ADDRESS = string 1..15 
FACILITIES = string 1..126 
USERJDATA = string 1.248 

Parameters OUTCALL _NAME (ON) 

Specifies a logical name associated with the REMOTE _DTE_ADDRESS. 
The logical name must be unique for each X.25 terminal gateway. 
Optionally, this logical name is available to the terminal user to help 
establish a foreign connection when the associated remote DTE address is 
a complete address. 

REMOTE _DTE .ADDRESS (RDA) 

Specifies the X.25 address of the destination X.25 system. It is specified as 
a string of digits through 9 or the wildcard character *. If the DTE 
address contains only digits, the associated outcall name is available to the 
terminal user during connection establishment. The wildcard character * 
alone allows you to enter any remote DTE address. You are not restricted 
to those remote DTE address(es) added by the network administrator. For 
example, RDA=*, implies that the user is authorized to enter any remote 
DTE address. RDA ='302*', implies that the user is authorized to enter 
remote DTE addresses that begin with 302. If the wildcard character is 
specified, it must be the last character in the entered string. Only one 
wildcard character may be entered. 

GATEWAY JVAME (GN) 

Specifies the name of the X.25 terminal gateway which provides access to 
the remote application. The X.25 terminal gateway must be previously 
defined. Defaults to the previously defined X.25 terminal gateway when 
entered in a configuration file. It is required when the command is entered 
by the operator. 
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LOCAL _PTE .ADDRESS (LDA) 

Specifies the X.25 address of a local X.25 trunk. It forces selection of a 
specific trunk over which interactive X.25 connections to a remote DTE are 
made. If specified, it is included in the call request passed to the X.25 
Packet Level. It must match a LOCAL _DTE_ADDRESS value on the 
DEFXI command. The call request is rejected by the X.25 Packet Level if 
no trunk with a matching LDA is found or if the matching trunk is 
DOWN. If not specified, and the gateway has been defined on multiple 
trunks, the X.25 Packet Level selects the X.25 trunk. The parameter is 
specified as a string of digits through 9. 

FACILITIES (F) 

Specifies the facilities options as defined by the CCITT X.25 
Recommendation. This parameter must be specified in order to use the fast 
select facility or for calls with reverse charges. This parameter must be 
entered as a string of an even number of hexadecimal digits. 

USER _D ATA (UD) 

Specifies an even-numbered string of hexadecimal digits that are included 
in the X.25 Call Request. The call is rejected if the concatenated string 
exceeds the maximum call user data field size. The maximum field size is 
124 octets with the fast select facility and 12 octets without the fast select 
facility (exclusive of the X.25 Call Request packet protocol field). The X.25 
terminal gateway automatically inserts the 4-byte protocol field at the 
beginning of the user data. 

Responses X.25 terminal gateway outcall <outcall_name> added. 

-ERROR- X.25 terminal gateway < gateway _name> is not defined. 

-ERROR- Remote _dte ..address can not include < string >. A remote _dte_ 
address may include only digits thru 9 or *. 

-ERROR- Remote _dte ..address may only include one wildcard character 
(*). 

-ERROR- Remote _dte_address can not have digit(s) following wildcard 
character (*). 

-ERROR- Outcall _name <name> already exists for X.25 terminal 
gateway < gateway _name>. 

-ERROR- Local _dte_address can not include < string >. A local _dte_ 
address may include only digits of thru 9. 

-ERROR- Facilities can only have an even number of hexadecimal digits. 

-ERROR- User_data can only have an even number of hexadecimal 
digits. 

-FATAL- Not enough memory available for required table space. 
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Examples In this example, the FACILITIES parameter options are reverse charging 
not requested and fast select not selected (to determine the packet size and 
window size, see the CCITT X.25 Recommendation book). 

add_x25_t erml na 1 _gw_out ca 1 1 on=so1 ver . . 
rda«'31 1061200260' .. 
gn=telenet_term1nal_gateway .. 
f='0100420707430202' 

X.25 terminal gateway out call SOLVER added. 

add_x25_t erml nal_gw_out call on=transpac_access .. 
rda='208»' .. 
gn=transpac_terminal_gateway .. 

X.25 terminal gateway outcall TRANSPAC.ACCESS added. 

The ADDXTGO command processor orders the outcall blocks based on the 
length of the remote DTE address string and the presence of the wildcard 
characters. Complete addresses are linked in descending size of the DTE 
address. 

Configuration file: 

addxt go, on=namel , rda=' 1 11111' gn=gw 
addxtgo,on=name2, rda=' 2222222' gn-gw 
addxt go , on-name3 , r da= ' 33333333 ' gn-gw 
addxt go , on=name4 , rda= ' 444444 ' gn=gw 

The above outcalls are linked and checked for matching criteria in the 
following order: 



name3 


33333333 


name2 


2222222 


name4 


444444 


namel 


111111 
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Any remote DTE address that contains a wildcard character is linked after 
complete DTE addresses, in descending size of the entered DTE address. 

Configuration file: 

addxtgo,on=name5,rda='3110*' gn=gw 
addxtgo,on=name6,rda='31 10612*' gn=gw 
addxt go , on=name7 , r da= ' 3 1 1 0408* * gn=gw 
addxtgo,on=name8,rda»'l*' gn=gw 
addxtgo,on=name9,rda='*' gn=gw 
addxtgo,on=name10,rda='*' gn=gw,lda='31 1040800146' 

Results in the following: 



name3 


33333333 


name2 


2222222 


name4 


444444 


namel 


111111 


name7 


3110408* 


name6 


3110612* 


natneB 


3110* 


names 


1* 


name 10 


* 


name9 


* 



The outcall name NAME9 is never used to satisfy a matching DTE address 
since NAME10 is the same string size but was entered after NAME9 and 
therefore linked ahead of NAME9. 

The concept of predefined outcall information mirrors the definition of X.25 
Gateway outcall title blocks, except that instead of registering the title in 
the directory, the outcall information is retained locally by the X.25 
terminal gateway. 
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CANCEL .CHANNEL .TRUNK (CANCT) (NOS MDI Only) 4-2 
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CANCEL Commands 



This chapter provides complete descriptions of all CDCNET Network Operations 
CANCEL commands. Command descriptions are organized alphabetically by full 
command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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CANCEL_CHANNEL_TRUNK (CANCT) (NOS MDI Only) 

CANCEL .CHANNEL .TRUNK (CANCT) (NOS MDI Only) 
NETOU Command 

Purpose Cancels the configuration of a channel trunk. The trunk is identified by its 
logical name. 

Format CANCEL .CHANNEL TRUNK 

TRUNK .NAME = name 

Parameters TRUNK .NAME (TN) 

The logical name of the trunk, assigned by the DEFINE .CHANNEL _ 
TRUNK command that configured the trunk. ~ 

Responses CHANNEL trunk <name> cancelled. 

--WARNING- Trunk <name> is not defined. 

-ERROR- Trunk <name> active, cannot be cancelled. 

-ERROR- Trunk <name> is not a CHANNEL trunk. 

-ERROR- VE interface < interface .name > cannot be cancelled by a 
cancel .channel .trunk command. 

-ERROR- Channel trunk < trunk name> cannot be cancelled until NP 
interface < interface name> is cancelled. 

Examples cancel .channel .trunk trunk_name = cyber101_alt 
CHANNEL trunk CYBER. 101_ALT cancelled. 
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CANCEL_DEV1CE_0UTCALL_SERVICE (CANDOS) 

CANCEL .DEVICE _OUTCALL .SERVICE (CANDOS) 
NETOU Command 

Purpose Cancels the definition of the Device Outcall Service. Because a DI supports 
only one device outcall at a time, the command requires no parameter to 
identify the service being cancelled. 

NOTE 

In future releases, this command will no longer be supported. You should 
start using the CANCEL _OUTCALL_GATEWAY command as soon as 
possible. 

Format CANCEL _DE VICE _OUTC ALL .SERVICE 

Parameters None. 

Responses Device Outcall Service cancelled. 

-WARNING— Device Outcall Service not defined. 
Examples cancel _device_outca1 l_service 

Device Outcall Service cancelled. 
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CANCEL _BGP_PEER (CANEP) 

CANCEL _EGP_PEER (CANEP) 
NETOU Command 

Purpose Cancels the definition of a peer previously defined by the DEFINE _EGP_ 
PEER command. Reference the peer by its IP Address. The specified peer 
must be stopped and in an idle state before it can be cancelled. 

Format CANCEL _EGP_PEER 

IP_ADDRESS = list 4 of 0..255 

Parameters IP_ADDRESS (IA) 

The IP address of the EGP peer gateway which is to be cancelled. This 
peer must have been previously stopped and in an idle state before this 
command executes. 

Responses EGP peer <ip_address> is cancelled. 

-ERROR- EGP peer <ip_address> is not defined. 

-ERROR- EGP peer <ip .address > is not stopped. 

-ERROR- EGP peer <ip_address> is not yet idle. 
Examples cancel _egp_peer ip_address = (128,5,0,3) 

EGP peer 128.5.0.3 is canceled. 
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CANCEL_ETHER_NET (CANEN) 

CANCEL JETHER_NET (CANEN) 
NETOU Command 

Purpose Cancels the configuration of an Ethernet network. The network is identified 

by its logical name. 

Format CANCEL _ETHER_NET 

NETWORK .NAME = name 

Parameters NETWORK _NAME (NN) 

The logical name of the network, assigned by the DEFINE _ETHER_NET 
command that configured the network. 

Responses Ethernet network < network _name> cancelled for trunk < trunk _name>. 

-WARNING- Network < network _name> not defined. 

-ERROR- Network < network _name> is active. It must be stopped before 
being cancelled. 

-ERROR— Network < network _name> is not an Ethernet network. 

Examples cancel _ether_net network_name=engin_bldg_net 

Ethernet network ENGIN_BLDG_NET cancelled for trunk ENGIN_BLDG_TRUNK. 
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CANCEL J!THER_TRUNK (CANET) 

CANCEL .ETHER JTRUNK (CANET) 
NETOU Command 

Purpose Cancels the configuration of an Ethernet trunk. The trunk is identified by 
its logical name. The Ethernet trunk cannot be cancelled unless the 
network has been previously cancelled. 

Format CANCEL _ETHER TRUNK 

TRUNK .NAME = name 

Parameters TRUNK _NAME (TN) 

The logical name of the trunk, assigned by the DEFINE _ETHER_TRUNK 
command that configured the trunk. 

Responses ETHERNET trunk <name> cancelled. 

-WARNING-- Trunk <name> not defined. 

-ERROR- Ether trunk < trunk name> cannot be cancelled until the Ether 
network < network _name> is cancelled. 

-ERROR- Trunk <name> is not an ETHERNET trunk. 

Examples cancel _ether_trunlc trunk_name=eng1n_bldg_nsouth 

Ethernet trunk ENGIN_BLDG_SOUTH cancelled. 
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CANCEL_FILE J5UPP0RT (CANFS) (NOS MDI Only) 



CANCEL .FILE .SUPPORT (CANFS) (NOS MDI Only) 
NETOU Command 

Purpose Cancels support for access of the specified file types from a MDI or MTI 
connection to a NOS host. If all file types defined for the host are 
cancelled, file access from the NOS host is terminated. 

Format CANCEL .FILE .SUPPORT 

FILEJTYPE = list 1..8 of keyword value 
TRUNKJVAME = name 

Parameters FILEJTYPE (FT) 

A list of one or more file types to be cancelled. The following file types 
are allowed. 

EXCEPTION 

BOOT 

DUMP 

LIBRARY 

CONFIGURATION 

TERMINAL .PROCEDURE 

USER_PROCEDURE 

LOAD .PROCEDURE 

ALL 

Default is ALL. 

TRUNK_NAME (TN) 

The trunk name of the logical link to the host for which support of the 
specified file types is cancelled. The value for this parameter is determined 
by the DI load process. Its use is not recommended. If TRUNK .NAME is 
not specified, the default trunk is used. The default trunk is either the 
trunk name as specified by a DEFINE _SYSTEM command or the trunk 
over which the DI was loaded. 

Responses File Support for specified file .types is cancelled for trunk <name>. 

-WARNING- File Support for specified file .types is cancelled for trunk 
<name>. <name> file .type was not defined. 

--WARNING- File Support was not defined for trunk <name>. 

-WARNING- File Support was not defined for the system. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

Examples cancel.fi le.support f1le_type=dump trunk_name=c170_trunk1 

File Support for specified file.types is cancelled for trunk d70_trunkl 
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CANCELJiDLCJJET (CANHN) 



CANCEL _HDLC_NET (CANHN) 
NETOU Command 

Purpose Cancels the configuration of an HDLC network. The network is identified 
by its logical name. 

Format CANCEL _HDLC _NET 

NETWORK _NAME = name 

Parameters NETWORK _NAME (NN) 

The logical name of the network assigned by the DEFINE _HDLC_NET 
command. 

Responses HDLC network < network _name> cancelled for trunk < trunk _name>. 

HDLC network < network _name> cancelled for trunks (< trunk _name> 
<trunk-name > ..). 

-WARNING- Network < network _name> is not defined. 

-ERROR- Network < network _name> is active. It must be stopped before 
being cancelled. 

-ERROR- Network < network _name> is not an HDLC network. 
Examples cancel _hdlc_net network.name = mem o_park_net work 

HDLC network MENLO_PARK_NETWORK cancelled for trunk MENLO_PARK_TRUNK. 
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CANCEL JIDLC JTBUNK (CANHT) 

CANCEL JHDLCJTRUNK (CANHT) 
NETOU Command 

Purpose Cancels the configuration of an HDLC trunk. The trunk is identified by its 
logical name. The HDLC trunk cannot be cancelled unless the network has 
been previously cancelled. 

Format CANCEL _HDLC TRUNK 

TRUNK .NAME = name 

Parameters TRUNK _NAME (TN) 

The logical name of the trunk, assigned by the DEFINE _HDLC_TRUNK 
command that configured the trunk. 

Responses HDLC trunk <name> cancelled. 

-WARNING- Trunk <name> not defined. 

-ERROR- Trunk <name> is not an HDLC trunk. 

-ERROR- Trunk <name> active, can not be cancelled. 

-ERROR- HDLC Trunk < trunk _name> cannot be cancelled until the 
HDLC network < network _name> is cancelled. 

Examples cancel_hdlc_trunk trunk.name = menlo_park_trunk_1 
HDLC trunk MENL0_PARK_TRUNK_1 cancelled. 
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CANCEL JPJKOST (CANIH) 

CANCEL _IP_HOST (CANIH) 
NETOU Command 

Purpose Cancels the definition of an Internet Protocol (IP) host and its associated 
routing information. The host is identified by its IP address. 

Format CANCEL _IPJHOST 

IP_ADDRESS = list 4 of 0..255 

Parameters IP_ADDRESS (IA) 

The IP address of the host, defined by the DEFINE JPJHOST command 
that configured the host. The format is similiar to the decimal octet 
convention used by the TCP/IP community, except the periods are replaced 
with commas and the list is enclosed in parentheses. For example, the IP 
address 128.2.53.7 is represented as (128,2,53,7). 

Responses IP address <ip .address > is cancelled. 

—WARNING— IP host address <ip_address> is not defined. 

—ERROR- IP address <ip_address> is invalid. 
Examples cancel _1p_host 1p_address=(128,2,53,7) 

IP address 128.2.53.7 is cancelled. 
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CANCEL_IP_NET (CANIN) 



CANCEL_IP_.NET (CANIN) 
NETOU Command 

Purpose Cancels the definition of an Internet Protocol (IP) network and its 

associated routing information. The network is referenced by its IP network 
address. 

Format CANCEL _IP_NET 

IP.NETWORK - list 1..4 of 0..255 

Parameters IP_NETWORK (IN) 

The IP address of the network or subnetwork, assigned by a DEFINE _IP_ 
NET command that configured the network. The format is similar to the 
decimal octet convention used by the TCP/IP community, except the periods 
are replaced with commas and the list is enclosed in parentheses. For 
example, the IP network 128.2.0.0 is represented as (128,2,0,0) or (128,2). 

Responses IP Network <ip_network> is cancelled. 

IP subnet <ip_network> is cancelled. 

-WARNING- IP Network <ip .network > is not defined. 

-WARNING- IP subnet <ip_network> is not defined. 

-ERROR- IP Network <ip_network> is invalid. Only the network 
number part of an IP address should be specified. 

Examples cancel_1p_net 1p_net»»ork=( 128,2,0,0) 
IP network 128.2.0.0 is canceled. 
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CANCEL_IPJC26_PDN_HOST (CANIXPH) 



CANCEL _IP_X25JPDN_HOST (CANIXPH) 
NETOU Command 

Purpose Cancels the definition of an IP X.25 PDN host and its associated routing 
information. The host is identified by its IP address. 

Format CANCEL _IP_X25 _PDN _HOST 

IP_ADDRESS = list 4 of 0..255 

Parameters IP_ADDRESS (IA) 

Specifies the IP address of the host, as previously defined by the 
DEFINE _IP_X25_PDN_HOST command that configured the host. The 
format is similar to the decimal octet convention used by the TCP/IP 
community, except that the periods are replaced with commas, and the list 
is enclosed in parentheses. For example, the IP address 128.2.53.7 is 
represented as (128,2,53,7). 

Responses IP address <ip_address> is cancelled. 

-ERROR- IP address <ip_address> is invalid. 

-ERROR- IP host address <ip_address> is not defined. 
Examples cancel _1p_x25_Ddn_host ip.address = (128,2,53,7) 

IP address 128.2.53.7 is cancelled. 
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CANCELJJNE (CANL) 



CANCEL JLINE (CANL) 
NETOU Command 

Purpose Cancels the configuration of a communication line or a URI line. The line 
is identified by its logical name. 

Format CANCEL .LINE 

LINE_NAME = name 

Parameters LINE_NAME (LN) 

The logical name of the line, assigned during configuration by the 
DEFINE _LINE command. 

Responses Line <line_name> cancelled. 

--WARNING- Line <line_name> not defined. 

-ERROR— Line <line_name> active, can not be cancelled. 

-ERROR- The device for line <line_name> is active and down, line 
cannot be cancelled. 

Remarks When a line active error occurs, the line must first be stopped using the 
STOP_LINE command before the line can be cancelled. When a device is 
active and down, the port testing must first be stopped using the STOP_ 
PORT_TEST command before the line can be cancelled. 

Examples cancel_line I1ne_name=eng1n_line_1 
Line ENGIN.LINE.1 cancelled. 
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CANCEL_LINE (CANL) 
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CANCELJSAMEJtESOLVER (CANNR) 

CANCEL _NAME _RESOLVER (CANNR) 
NETOU Command 

Purpose Causes the Domain Name Resolver to stop accepting requests from users. 

Format CANCEL _NAME .RESOLVER 

Parameters None. 

Responses Domain Name Resolver is cancelled. 

—WARNING - Domain Name Resolver is not defined. 

Examples cance 1 _name_r eso 1 ver 

Domain Name Resolver is cancelled. 
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CANCEL _NP_INTERFACE (CANNI) (NOS MDI Only) 



CANCEL _NP ..INTERFACE (CANNI) (NOS MDI Only) 
NETOU Command 

Purpose Cancels the configuration of a NOS Network Products (NP) interface. 

Format CANCEL _NP_INTERFACE 

INTERFACE _NAME = name 

Parameters INTERFACE _NAME (IN) 

The logical name of the interface assigned by a DEFINE _NP_INTERFACE 
command. 

Responses NP interface < interface _name> cancelled for trunk < trunk _name>. 

-WARNING- NP interface < interface _name> is not defined. 

-ERROR— NP interface < interface _name> is active. It must be stopped 
before being cancelled. 

-ERROR- NP interface < interface _name> has active users. They must 
be cancelled before the NP interface can be cancelled. 

Examples cancel_np_1nterface 1n=cyber_109 

NP interface CYBER.109 cancelled for trunk $MCI2. 
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CANCEL J«>_TERMINAL_GW (CANNTG) 

CANCEL _NPJTERMINAL GW (CANNTG) 
NETOU Command 

Purpose Cancels the configuration of an NP terminal gateway. Cancels all titles 
associated with the gateway. 

Format CANCEL _NP_TERMINAL GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the interface assigned by a DEFINE NP_ 
TERMINAL. GW command. 

Responses NP terminal gateway < gateway _name> cancelled. 

-WARNING- NP terminal gateway < gateway _name> is not defined. 

-ERROR- NP terminal gateway < gateway _name> is active. It must be 
stopped before being cancelled. 

Examples cancel_np_terminal_gv« gn = ivt_109 

NP terminal gateway IVT_109 cancelled. 
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CANCEL_0PERAT0RJ3UPP0RT (CANOS) (NOS MD1 Only) 

CANCEL ..OPERATOR J3UPPORT (CANOS) (NOS MDI Only) 
NETOU Command 

Purpose Cancels support for the Operator Support Application in an MDI or MTI. 

The Operator Support Application allows network operators to communicate 
with the network DIs through a particular MDI or MTI, using the Network 
Operator Utility (NETOU). 

This command suppresses all responses to outstanding commands from 
operators connected through the host. 

Format CANCEL _OPER ATOR .SUPPORT 

TRUNK JfAME = name 

Parameters TRUNK _NAME (TN) 

The trunk name of the logical link to the host for which operator support 
is cancelled. If this parameter is not specified, the default value is used. 

Responses Operator Support is cancelled for trunk <name>. 

-WARNING- Operator Support was not defined for trunk <name>. 

-WARNING- Operator Support was not defined for the system. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-FATAL- Unable to cancel Operator Support for trunk <name>. 

Examples cancel .operator .support trunk_name=c170_trunk1 

Operator Support 1s cancel led for c170_trunk 



4-16 CDCNET Commands 



60000414 C 



CANCEL_OUTCALL_GATEWAY (CANOG) 

CANCEL _OUTCALL_GATEWAY (CANOG) 
NETOU Command 

Purpose Cancels the definition of the Outcall Gateway from a DI. Since there can 
be only a single instance of the Outcall Gateway in a DI, the command 
does not require any parameters to identify the Outcall Gateway being 
cancelled. 

Format CANCEL _OUTCALL .GATEWAY 

Parameters None. 

Responses Outcall Gateway is cancelled. 

-WARNING- Outcall Gateway is not defined. 

—ERROR— Outcall Gateway must be stopped before cancelling. 
Examples cance 1 _out ca 1 1 _gat eway 

Outcall Gateway Is cancelled. 
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CANCEL J»ASSTHROUGH_SERVICE (CANPS) 



CANCEL JPASSTHROUGH .SERVICE (CANPS) 
NETOU Command 



Purpose 



Cancels the definition of the passthrough service currently supported by a 
DI. Because a DI supports only one passthrough service at a time, the 
command requires no parameter to identify the passthrough service being 
cancelled. 

NOTE 



In future releases, this command will no longer be supported. You should 
start using the CANCEL _OUTCALL .GATEWAY command as soon as 
possible. 



Format CANCEL .PASSTHROUGH .SERVICE 

Parameters None. 

Responses Passthrough service cancelled. 

-WARNING- Passthrough Service not defined. 
Examples cance 1 _passthrough_servl ce 

Passthrough service cancelled. 
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CANCEL_RECORDER JX>G_GROUP (CANRLG) (NOS MDI Only) 



CANCEL JRECORDER_LOG_GROUP (CANRLG) (NOS MDI Only) 
NETOU Command 

Purpose Cancels the recording of a log group at an MDI or MTI connected to a 

NOS host. The Independent Log Management Entity in the MDI no longer 
records the cancelled group (the recorder DI no longer logs the source log 
messages to the network log file on the host). If no groups are recorded by 
an Independent Log ME, this command terminates the log recording 
function. If no other recorders are defined for the log group, this command 
always terminates the Independent Log ME log recording function for the 
DI and the log group. The current CDCNET release supports only one log 
group per MDI or MTI. 

Format CANCEL .RECORDER _LOG_GROUP 

LOGjGROUP = name 
TRUNK_NAME = name 

Parameters LOGjGROUP (LG) 

Specifies the logical name of the log group for which support is to be 
cancelled. The default log group supported for this release is CATENET. A 
DI can belong to only one log group. Each recorder DI supports one named 
log group. 

TRUNK_NAME (TN) 

The trunk name of the logical link to the host for which the specified log 
groups are cancelled. If TRUNK _NAME is not specified, the default trunk 
is used. The default trunk is the default channel trunk, as specified by the 
DEFINE .SYSTEM command or if not specified on the DEFINE .SYSTEM 
command, the channel trunk over which the DI was loaded. 

Responses Recorder log group is cancelled for trunk <name>. 

-WARNING- Specified recorder log group is cancelled for trunk <name>. 
Recorder log group <name> was not defined. 

-WARNING- Recorder log groups were not defined for trunk <name>. 

-WARNING- Recorder log groups were not defined for the system. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

Examples cancel .recorder. log_group lg=catenet tn=c170_trunlc1 

Recorder log groups are cancelled for trunk c170_trunk1. 
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CANCEL _REM0TE_LJNE_MONITOR (CANRLM) 

CANCEL _REMOTE_LINE .MONITOR (CANRLM) 
DI Configuration/NETOU Command 

Purpose Cancels the selected Remote Line Monitor. 

Format CANCEL .REMOTE _LINE .MONITOR 

Parameters None. 

Responses Remote Line Monitor cancelled, $LIM <lim>_PORT <port>. 

Remote Line Monitor not defined for this DI. 

Examples cance 1 _r emot e_ 1 1 ne_mon 1 tor 

Remote Line Monitor cancelled, $LIM5_PORT0. 
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CANCEL_REMOTE_LOAD_SUPPORT (CANRLS) 

CANCEL .REMOTE _LOAD .SUPPORT (CANRLS) 
NETOU Command 

Purpose Cancels support of the CDCNET system for loading and dumping systems 
through the networks directly connected to the CDCNET system. The 
command stops and deletes the Initialization Management Entity from the 
system. 

Format CANCEL .REMOTE _LO AD JSUPPORT 

Parameters None. 

Responses Remote Load Support is cancelled. 

-WARNING- Remote Load Support is not defined for this system. 

Remarks For more information on the Initialization Management Entity, see the 
DEFINE _REMOTE_LOAD .SUPPORT command in this manual. 

Examples cancel _remote_load_support 

Remote Load Support is cancelled. 
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CANCELJ3ERVER_TELNET_GW (CANSTG) 



CANCEL JSERVER JTELNET_GW (CANSTG) 
NETOU Command 

Purpose Cancels the definition of a server TELNET gateway. The gateway must be 
stopped using the STOP_SERVER_TELNET_GW command before it can 
be cancelled with this command. 

Format CANCEL ^SERVER _TEL.NET GW 

GATEWAY_NAME = name 



Parameters GATEWAY_NAME (GN) 

The logical name of the server TELNET gateway defined by a DEFINE _ 
SERVER_TELNET_GW command. 

Responses Server TELNET gateway < gateway _name> is cancelled. 

-WARNING- Server TELNET gateway < gateway _name> is not defined. 

-ERROR- Server TELNET gateway < gateway _name> is active. It must 
be stopped before being cancelled. 

Examples cancel_server_telnet_gw gateway_name=gw_to_cyber 
Server TELNET gateway GW_TO_CYBER 1s cancelled. 



4-22 CDCNET Commands 



60000414 C 
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CANCEL _SLIP_GW (CANSG) 
NETOU Command 

Purpose Cancels the definition of a SLIP gateway and the associated SLIP host 

entries. Use the STOP_SLIP_GW command to stop the gateway before 
cancelling it with this command. 

Format CANCEL _SLIP_GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the SLIP gateway defined by a DEFINE _SLIP_GW 
command. This parameter is required. 

Responses SLIP gateway < gateway _name> is cancelled. 

-ERROR- SLIP gateway < gateway _name> is not defined. 

-ERROR- SLIP gateway < gateway _name> is active. It must be stopped 
before being cancelled. 

Examples cancel_slip_gw gateway_name=slip_gw 
SLIP gateway SLIP.GW Is cancelled. 
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CANCEL _SLIP_HOST (CANSH) 
NETOU Command 

| Purpose Deletes the specified SLIP entry. 



I Format CANCEL _SLIP HOST 

I HOST_NAME = name 

I GATEWAY_NAME = name 

I Parameters HOST_NAME (HN) 

| The name of the SLIP host entry to delete. This parameter is required. 

I GATEWAY_NAME (GN) 

| The logical name of the SLIP gateway for which this entry was used. This 

| parameter is required. 

I 

I Responses SLIP host <host_name> is deleted from gateway < gateway _name>. 

1 -ERROR- SLIP host <host_name> not found. 

1 -ERROR- SLIP gateway < gateway _name> is not defined. 

1 

I Examples cancel_s1ip_host gateway_name=sl ip_gw host_name=host_1 

| SLIP host H0ST_1 is deleted from gateway SLIP_GW. 
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CANCEL_SNMPJVGENT (CANSA) 

CANCEL _SNMP_AGENT (CANSA) 
NETOU Command 

Purpose Cancels the SNMP Agent previously defined by the DEFINE _SNMP_ 

AGENT command. As part of the cancellation, the communities previously 
added by ADD J3NMP_COMMUNITY are deleted. 

Format CANCEL _SNMP_AGENT 

Parameters None. 

Responses The SNMP Agent has been cancelled. 

-WARNING-- The SNMP Agent is not defined. 

Examples cancel _snmp_agent 

The SNMP Agent has been cancelled. 
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CANCEL .SOURCE .ALARM .GROUP (CANSAG) 
NETOU Command 

Purpose Cancels the alarm group(s) that the Dependent Log ME belongs to. 

Format CANCEL _SOURCE _ALARM _GROUP 

ALARM _GROUP = list 1..15 of name 

Parameters ALARM JGROUP (AG) 

Specifies the alarm group or list of alarm groups to be cancelled from the 
Dependent Log ME alarm environment. Default is CATENET. 

Responses Source alarm groups cancelled. 

-WARNING- Specified source alarm groups cancelled. Source alarm group 
<name> was not defined. 

—WARNING— No source alarm groups defined. 

-ERROR- Duplicate alarm group <name> specified. 

Examples cancel _source_alarm_group alarm_group = catenet 

Source alarm groups cancelled. 
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CANCEL .SOURCE _ALARM .MESSAGE (CANSAM) 
NETOU Command 

Purpose Cancels the reporting of specified alarm messages by a DI. The message 
numbers specified are removed from the list of alarms to be sent from a 
DI. 

Format CANCEL .SOURCE .ALARM .MESSAGE 

MESSAGE .NUMBER = list 1..63 range of 1..32999 

Parameters MESSAGE .NUMBER (MN) 

Specifies alarm message numbers of one or more alarm messages to be 
cancelled. See the online CDCNET Diagnostic Messages manual for the 
complete list of alarm messages and their identifier numbers. 

Responses Source alarm messages cancelled. 

Examples cancel_source_alarm_message mn=(3, 42. .45,87) 

Source alarm messages cancelled. 
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CANCEL _SOURCE_LOG_GROUP (CANSLG) 
NETOU Command 

Purpose Cancels the current definition of the logging function for DIs acting as 
sources of log messages. This release allows definition of only one log 
group per system; therefore this command cancels all logging by a DI. To 
reenable logging, a DEFINE .SOURCE _LOG_GROUP command should 
immediately follow a CANCEL_SOURCE_LOG_GROUP command. 

Format CANCEL .SOURCE _LOG .GROUP 

LOGjGROUP = name 

Parameters LOGJGROUP (LG) 

The logical name for the log group to cancel from reporting. The default 
log group is CATENET. 

Responses Source log group cancelled. 

—WARNING— Specified source log group cancelled. Source log group 
<name> was not defined. 

-WARNING— No source log groups defined. 

Examples cancel _source_lo9_group log_group=catenet 

Source log group cancelled. 
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CANCEL _TCPIP_GW (CANTG) 
NETOU Command 

Purpose Cancels the definition of an application interface gateway for TCP/IP 

applications such as FTP and SMTP. The gateway must be stopped using 
the STOP_TCPIP_GW command before it is cancelled with this command. 

Format CANCEL _TCPIP_GW 

GATEWAY_NAME = name 

Parameters GATEWAY.NAME (GN) 

The logical name of the TCP/IP application gateway defined by a 
DEFINE _TCPIP_GW command. 

Responses TCP/IP gateway < gateway _name> is cancelled. 

-WARNING- TCP/IP gateway < gateway _name> is not defined. 

-ERROR- TCP/IP gateway < gateway _name> is active. It must be 
stopped before being cancelled. 

Examples cancel _tcpip_gw gateway_name=ftp_gw 
TCP/IP gateway FTP_GW is cancelled. 
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CANCEL _UDP_INTERFACE (CANUI) 
NETOU Command 

Purpose Cancels the definition of the user datagram protocol (UDP) interface layer. 

Format CANCEL _UDP_INTERFACE 

Parameters None. 

Responses UDP interface is cancelled. 

-WARNING- UDP interface is not defined. 

-ERROR- UDP interface is active. It must be stopped before being 
cancelled. 

Examples cancel_udp.1nterface 

UDP Interface 1s cancelled. 
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CANCEL _USER _TEL.NET GW (CANUTG) 
NETOU Command 

Purpose Cancels the definition of a user TELNET gateway. The gateway must be 
stopped using the STOP_USER_TELNET_GW command before it can be 
cancelled. 

Format CANCEL ..USER .TELNET GW 

GATEWAY.NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the user TELNET gateway defined by a DEFINE. 
USER_TELNET_GW command. 

Responses User TELNET gateway < gateway _name> is canceled. 

-WARNING- User TELNET gateway < gateway _name> is not defined. 

-ERROR- User TELNET gateway < gateway _name> is active. It must be 
stopped before being canceled. 

Examples cancel_user_telnet_gw gateway_name=gw_to_vax 
User TELNET gateway GW_TO_VAX is canceled. 
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CANCEL _USER .VALIDATION (CANUV) 
NETOU Command 

Purpose Cancels the validation of users connected to CDCNET through this DI. 

Format CANCEL _USER .VALIDATION 

Parameters None. 

Responses User validation is cancelled. 

—WARNING- User validation is not defined. 
Examples cancel_user ..validation 

User validation is cancelled. 
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CANCEL _X25_ASYNCTIP (CANXA) 
NETOU Command 

Purpose Cancels the X.25 asynchronous TIP service supported by the specified X.25 
trunk(s). 

Format CANCEL _X25 _ASYNCTIP 

TRUNK _NAME = list 1..32 of name 

Parameters TRUNK _NAME (TN) 

The logical name for the trunk(s) for which X.25 asynchronous TIP service 
is to be cancelled. The logical name for the trunk(s) was assigned by the 
DEFINE _X.25_TRUNK command that configured the trunk(s). 

Responses X.25 AsyncTip support cancelled for specified trunks. 

-ERROR- Trunk < trunk _name> is not a X.25 trunk. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- X.25 AsyncTip support not defined for trunk < trunk _name>. 

-ERROR- X.25 AsyncTip support active for trunk < trunk _name>. 
Service for this trunk must be stopped before being cancelled. 

-ERROR- X.25 AsyncTip support active for one or more of the specified 
trunks. Service for these trunks must be stopped before being cancelled. 

Examples cancel _x25_asynct 1 p trunk_name = telenet_2 

X.25 AsyncTip support cancelled for specified trunks. 
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CANCEL _X25_GW (CANXG) 
NETOU Command 

Purpose Cancels the configuration of an X.25 gateway and the X.2S outcall titles 

associated with the gateway. 

Format CANCEL _X25 _GW 

GATEWAY JSfAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the gateway assigned by a DEFINE _X25_GW 
command. 

Responses X.25 gateway < gateway _name> is cancelled. 

-WARNING— X.25 gateway < gateway _name> is not defined. 

-ERROR- X.25 gateway < gateway _name> is active. It must be stopped 
before being cancelled. 

Remarks The X.25 gateway must be stopped by a STOP_X25_GW command before 
it can be cancelled. 

Examples cancel _x25_gw gn=teienet_gw 

X.25 gateway TELENETJ3W 1s cancelled. 
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CANCEL _X25 ..INTERFACE (CANXI) 
NETOU Command 

Purpose Cancels the configuration of an X.25 interface. 

Format CANCEL _X25 .INTERFACE 

INTERFACE _NAME = name 

Parameters INTERFACE _NAME (IN) 

The logical name of the interface assigned by a DEFINE _X25_ 
INTERFACE command. 

Responses X.25 interface < interface _name> cancelled for trunk < trunk _name>. 

-WARNING- X.25 interface < interface _name> is not defined. 

-ERROR- X.25 interface < interface _name> is active. It must be stopped 
before being cancelled. 

—ERROR- X.25 interface < interface _name> has active users. They must 
be cancelled before the X.25 interface can be cancelled. 

Remarks Before the X.25 interface can be cancelled, the interface must be stopped 
by the STOP_X25 .INTERFACE command, and the X.25 gateway and X.25 
network must be cancelled by the CANCEL _X25_GW and CANCEL _ 
X25_NET commands. 

Examples cancel_x25_1nterface in=telenet_2 

X.25 Interface TELENET_2 cancelled for trunk TELENET2. 
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CANCEL _X25_NET (CANXN) 
NETOU Command 

Purpose Cancels the configuration of a X.25 network. The network is identified by 
its logical name. 

Format CANCEL _X25 _NET 

NETWORK _NAME = name 

Parameters NETWORK _NAME (NN) 

The logical name of the network assigned by the define command 
(DEFINE _X25_NET) that configured the network. 

Responses X.25 network < network _name> cancelled for trunk < trunk _name>. 

-WARNING- Network < network _name> is not defined. 

-ERROR- Network < network _name> is active. It must be stopped before 
being cancelled. 



Remarks 



-ERROR— Network < network _name> is not an X.25 network. 

The X.25 network must be stopped by the STOP_NETWORK command 
before it can be cancelled. 



Examples cancel _x25_.net network_name=tymnet_net_1 

X.25 network TYMNET_NET_1 cancelled for trunk 
TYMNET_TRUNK_3. 
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CANCEL _X25 .TERMINAL _GW (CANXTG) 
NETOU Command 

Purpose Cancels the configuration of an X.25 terminal gateway. 

Format CANCEL _X25 .TERMINAL GW 

GATEWAY_NAME = name 

Parameters GATEWAY.NAME (GN) 

Logical name of the gateway assigned by a DEFXTG command. 

Responses X.25 terminal gateway < gateway _name> is cancelled. 

-WARNING- X.25 terminal gateway < gateway _name> is not defined. 

—ERROR- X.25 terminal gateway < gateway _name> is active. It must be 
stopped before being cancelled. 

Examples cancel _x25_term1na1_gw gn = datapac_term1nal_gateway 

X.25 terminal gateway DATAPAC_TERMINAL_GATEWAY is cancelled. 
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CANCEL _X25_TRUNK (CANXT) 
NETOU Command 

Purpose Cancels the configuration of an X.25 trunk. The trunk is identified by its 
logical name. 

Format CANCEL _X25 TRUNK 

TRUNK _NAME = name 

Parameters TRUNK _NAME (TN) 

The logical name of the trunk assigned by the define command (DEFINE _ 
X25_TRUNK) that configured the trunk. 

Responses X.25 trunk <name> cancelled. 

-WARNING- Trunk <name> is not defined. 

-ERROR- Trunk <name> is not an X.25 trunk. 

-ERROR- X.25 trunk < trunk _name> cannot be cancelled until the 
interface < interface _name> is cancelled. 

- ERROR- Trunk <name> active, can not be cancelled. 

Remarks The X.25 interface for the trunk must be stopped by a STOP_X25_ 

INTERFACE command and cancelled by the CANCEL _X25 .INTERFACE 
command, before the trunk can be cancelled. 

Examples cancel _x25_trunk trunk_name»tymnet_trunk_1 
X.25 trunk TYMNET_TRUNK_1 cancelled. 
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This chapter provides complete descriptions of all CDCNET CHANGE commands used 
for network configuration and operations. Command descriptions are organized 
alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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CHANGE _CDCNET .ADDRESS .PREFIX (CHACAP) 
DI Configuration Procedure/NETOU Command 

Purpose Changes the prefix and/or size of the CDCNET NSAP address. 

An address prefix identifies a group of NSAP addresses. Part of each 
address in this group, called the address prefix, has the same value. As 
implied by its name, the CDCNET NSAP address prefix identifies the 
value of a common part of all CDCNET NSAP addresses. 

When this command executes from a configuration file, the prefix and/or 
NSAP address size change occurs when system configuration completes. 
However, in this case, the system goes through one additional reset if the 
address prefix or size specified in the CHACAP command differs from its 
previously configured value. 

Format CHANGE _CDCNET .ADDRESS .PREFIX 

ADDRESS JPREFIX = string "of 4.22 
ADDRESS _SIZE = U..20 

Parameters ADDRESS _PREFIX (AP) 

Prefix of CDCNET NSAP addresses. Specify this value as a string of 
hexadecimal digits, and include all leading or trailing zeros. The address 
prefix value must include an even number of hexadecimal digits. 

If this parameter is omitted, the CHACAP command does not change the 
previously configured or initialized address prefix. 

ADDRESS _SIZE (AS) 

Size, in bytes, of the CDCNET NSAP addresses. Specify this value as a 
decimal number between 11 and 20. 

If this parameter is omitted, the CHACAP command does not change the 
previously configured or initialized address size. 

Responses CDCNET NSAP address prefix and address size are changed. 

CDCNET NSAP address prefix is changed. 

CDCNET NSAP address size is changed. 

Change of NSAP addressing accepted. No values are changed. 

-WARNING- CDCNET NSAP address prefix and address size are changed. 
CDCNET NSAP address prefix was already < address _prefix>. CDCNET 
NSAP address size was already < address _size>. 

-WARNING- CDCNET NSAP address prefix and address size are changed. 
CDCNET NSAP address size was already < address _size>. 

-WARNING- CDCNET NSAP address prefix and address size are changed. 
CDCNET NSAP address prefix was already < address _prefix>. 

-WARNING- CDCNET NSAP address prefix is changed. CDCNET NSAP 
address prefix was already < address _prefix>. 

-WARNING- CDCNET NSAP address size is changed. CDCNET NSAP 
address size was already < address _size>. 
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-ERROR- The address prefix < address _prefix> contains non-hex 
characters. 

-ERROR- The address prefix < address _prefix> string length is not even. 

—ERROR- The address size is not large enough to accommodate the 
address prefix and the fixed portion of the CDCNET NSAP address. The 
address size must be at least 9 octets greater than the address prefix 
string length divided by two. 

-ERROR- Change _cdcnet_address_prefix can not be executed through the 
Network Operations Facility. Change _cdcnet_address_prefix may only be 
executed through a Device Interface configuration file. 

Remarks This command is not required in a DI configuration file. Values in 

battery-backed RAM for the address prefix CDCNET NSAP address size 
are used if this command is not in a DI's configuration file. These initial 
system values are summarized in the Software Release Bulletin for the 
release that includes OSI. 

Examples change_cdcnet_address_pref ix ap='0447' 
CDCNET NSAP address prefix is changed, 
change.cdcnet _address_pref i x as= 1 7 
CDCNET NSAP address size Is changed. 

The following examples further illustrate implications of changing the 
address prefix and/or CDCNET NSAP address size. Assume the following 
as initial or default values for the address prefix and CDCNET NSAP 
address size. 

Size of the address prefix: 4 bytes 
Value of the address prefix: 0047ee03(16) 
Size of the NSAP address: 17 bytes 

The following diagram represents these values for the CDCNET NSAP 
address. 



ADDRESS 
PREFIX 


UNUSED 


SUBNET 
ID 


SYSTEM 

D 


NSAP 
SELECTOR 


00 


47 


ee 


03 


00 


00 


00 


00 



4 Bytes 4 Bytes 



9 Bytes 



M02517 
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The command: 

change_cdcnet_address_prefix ap='044703' 

results in the following values for the address prefix, NSAP address size, 
and address format: 

Size of the address prefix 3 bytes 
Value of the address prefix 044703(16) 
Size of the NSAP address 17 bytes 

This command results in the following format for the CDCNET NSAP 
address: 



ADDRESS 
PREFIX 


UNUSED 


SUBNET 
D 


SYSTEM 
ID 


NSAP 
SELECTOR 


04 


47 


03 


00 


00 


00 


00 


00 






















► 



3 Bytes 



5 Bytes 



9 Bytes 



M02518 



Assuming the above format to be the initial or current format of the 
CDCNET NSAP address, execution of the command: 

change_cdcnet_address_pref i x as=15 

results in the following: 

Size of the address prefix 3 bytes 
Value of the address prefix 044703(16) 
Size of the NSAP address 15 bytes 

This results in the following format for the CDCNET NSAP address: 



ADDRESS 
PREFIX 


UNUSED 


SUBNET 
ID 


SYSTEM 
D 


NSAP 
SELECTOR 


04 


47 


03 


00 


00 


00 


<- 




-> 


-#- 




-► 


4 







3 Bytes 3 Bytes 
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CHANGE .CHANNEL JTRUNK (CHACT) (NOS MDI Only) 
NETOU Command 

Purpose Changes the channel timeout value of the channel trunk. 

Format CHANGE .CHANNEL TRUNK 

TRUNK _NAME = name 
CHANNEL JTIMEOUT = boolean 

Parameters TRUNK _NAME (TN) 

Logical name of the channel trunk. 

CHANNEL JTIMEOUT (CT) 

How MCI software handles host peripheral processor (PP) interruptions. 
This parameter is intended for use by customers during joint software 
development with Control Data. The following values are allowed: 



Value 



Description 



TRUE MCI software detects when a host PP stops 

operating, downs the channel interface, and 
attempts recovery. 

FALSE MCI software does not detect when a host PP 

stops operating. Specify FALSE only when 
debugging host PP software. 

Default is not to change the current parameter value. 

Responses CHANNEL trunk < trunk _name> options are changed. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- Trunk <trunk_name> is not a CHANNEL trunk. 

Examples change.channel .trunk trunk_name=C180_CHANNEL_1 channel .timeout 
=FALSE 

CHANNEL trunk C180_CHANNEL_1 options are changed. 
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CHANGE _CLNS (CHAC) 
NETOU Command 

Purpose Changes various operating characteristics of the connectionless mode 
network service (CLNS) entity. 

Format CHANGE _CLNS 

HEADER JCHECKSUM = boolean 

DERIVED _PDU RETENTION JTIME = 1..500 

PDU .MAXIMUM LIFETIME = 1..256 

Parameters HEADER JCHECKSUM (HC) 

Controls use the of checksum for the header of an outgoing CLNS initial 
PDU. 

If TRUE, the CLNS entity calculates the checksum for the header that is 
prefixed onto the initial PDU. If the initial PDU needs to be segmented, 
the CLNS entity also checksums each derived PDU header. 

If FALSE, the entity does not calculate the checksum for the header. 

Initial value is FALSE. 

DERIVED _PDU_JlETENTION_TIME (DPRT) 

Time, in seconds, the DI retains any derived PDUs it receives that do not 
form a complete initial PDU. 

The CLNS entity combines the derived PDUs that it receives into the 
initial PDUs from which they were formed. If an initial PDU cannot be 
formed before the DPRT time expires, the derived PDUs for the initial 
PDU are discarded. The DPRT timer has a resolution of 5 seconds. 

A small DPRT value ensures that DI resources is used only for a short 
time for PDUs that cannot be combined into a complete Initial PDU. 

A large DPRT value ensures that PDUs transmitted over a slow medium 
are combined even when there is a long delay in receiving PDUs through 
that medium. 

If all networks in the catenet are fast, like ETHERNET, then the DPRT 
value should be set low, for example, to 5 seconds. If the catenet includes 
a slow network, like an HDLC network running at 2400/4800 bps, then the 
DPRT value should be increased so that PDUs sent over the slow network 
are not discarded unnecessarily. 

Initial value is 10 seconds. 

PDU .MAXIMUM .LIFETIME (PML) 

Maximum hops a network PDU can traverse. If a network PDU traverses 
more than the hops specified by this parameter, the PDU is discarded and 
an error PDU is sent back to the originator of the PDU. The error PDU 
states that the lifetime was exceeded. Set the value of PML to at least 
four times the number of hops in the longest path in the network. Initial 
value is 64 hops. 

Responses CLNS environment updated. 

Examples change.clns header_checltsum=TRUE 

CLNS environment updated. 
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CHANGE .DIRECTORY (CHAD) 
NETOU Command 

Purpose Changes the version of the CDCNET Directory ME that the system uses. 

NOTE 



This command is optional in the DI configuration file. 



Format 



Parameters 



CHANGE .DIRECTORY 
VERSION = 2..3 

VERSION (V) 

Specifies the Directory ME version used in transmitting directory PDUs. 
Both versions 2 and 3 are supported in receiving directory PDUs. Version 
3 is more efficient than 2. Control Data recommends that you upgrade the 
entire catenet (including all NOS/VE hosts) before changing the version, 
since version 3 PDUs are not supported by older versions. The initial value 
for this parameter is 3. 

Responses Directory M-E version changed. 
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CHANGE _ELEMENT_STATE (CHAES) 
NETOU Command 

Purpose Changes the operational state of DI hardware. DI hardware may be placed 
in the OFF, ON, or DOWN state (states described below). If you use this 
command, you must also stop the communications traffic or the diagnostics 
being run on the device whose state you are changing, using the 
appropriate STOP command. DI hardware devices are addressed by their 
physical names. 

Format CHANGE .ELEMENT STATE 

DEVICE .NAME = name 
STATE = keyword value 

Parameters DEVICE .NAME (DN) 

Physical name of the device. This name may have the following values. 

For boards: $, board type (0..7) and board slot number, as in $ESCI6. 



For LIM ports: 



STATE (S) 



$, the keyword LIM followed by the LIM board slot 
number and the keyword PORT followed by the port 
number on the LIM, as in $LIM5_PORTl. 



Desired new state for the device. The following keyword values are 
allowed. 



Keyword Value 



Description 



OFF 



ON 



DOWN 



Sets the device as inactive, so that the device 
cannot be used or have commands sent to it. The 
only action allowed against a device in the OFF 
state is to send a CHANGE _ELEMENT_STATE 
command to change the state from OFF to another 
state. 

Sets the device in the ON state. ON is the required 
state for using the device for CDCNET 
communications. 

Sets the device as available for diagnostics only. 
Executing a diagnostic test for a device changes its 
state to DOWN. If the diagnostic fails, the device 
remains in the DOWN state. If the diagnostic test 
passes, the device is placed in the ON state. 
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Responses Device < device _name> < state > (ON, OFF, or DOWN). 

—ERROR-- Device < device _name> is not installed in system. 

—ERROR— Device < device _name> active. Stop communications or 
diagnostics before changing device state. 

Examples change_element_state dev1ce_name=$c1m4,state=down 

Device $CIM4 down. 
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CHANGE JESIS .ROUTING .OPTIONS (CHAERO) 
DI Configuration Procedure/NETOU Command 

Purpose Selects the OSI ES-IS Routing function to be supported in a CDCNET 
system. It allows you to change one or more configurable attributes of 
ES-IS routing support. 

By default, each CDCNET system supports the end system and 
intermediate system routing functions. Therefore, you need this command 
only if the system needs to support the end system routing function. You 
can also use this command to change one or more attributes of the end or 
intermediate system routing function. 

This command may be included in the configuration file or executed as an 
online operator command. 

Format CHANGE _ESIS .ROUTING OPTIONS 

ROUTING JUNCTION = keyword 

ES JCONFIGURATION JTIMER = 30..3600 

IS ..CONFIGURATION JTIMER = 10. .1200 

ROUTING _CACHE JNACTWITY JTIMER = 60..1200 

ENABLE JCHECKSUM = boolean 

CONS_ROUTING_SUPPORT = boolean 

ENABLE JCONFIGURATION ^NOTIFY = boolean 

Parameters ROUTING JUNCTION (RF) 

Changes the OSI routing functions present in the CDCNET system. One of 
the following keywords may be used: 



Keyword 



Description 



ES Selects the end system routing functions. 

IS Selects both end system and intermediate system 

routing functions. 

COMBINED Selects both end system and intermediate system 

routing functions. 

In general, an ES has limited routing knowledge; IS and COMBINED have 
global routing knowledge. Communication between end systems on directly 
connected networks may be affected if a system resets an IS or 
COMBINED. The communication is fully restored either when the system 
that reset is reconfigured, or when its holding timer (derived from IS_ 
CONFIGURATION _TIMER) expires in the end systems involved. 

A system that has multiple network solutions should be COMBINED. A 
system that has at least one X.25 network solution should also be 
COMBINED because the ES-IS protocol is not designed to operate over 

PDNs. 
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If CONS is configured in a given system (by CHANGE _ESIS .ROUTING 
OPTIONS or CHANGE _OSI .TRANSPORT), at least one system on each 
directly connected network must be configured as a COMBINED system. 
When an end system is defined that has CONS configured by the 
CHANGE _OSI_TRANSPORT command, all systems on the directly 
connected network that are configured as COMBINED systems must have 
CONS configured (by CHANGE _ESIS .ROUTING .OPTIONS or 
CHANGE _OSI .TRANSPORT). 

The initial value of this parameter is COMBINED. 
NOTE 



The initial value is the value used for a given attribute when that 
attribute has not been specified in any previous use of this command. 



ES ..CONFIGURATION JTIMER (ECT) 

Changes the value of the configuration timer used to control the rate at 
which an end system transmits End System Hello PDUs. A higher value 
reduces the CPU overhead but increases the time it takes other systems to 
learn about changes in the NSAP addresses present in the system or about 
this system having gone down. The value is specified in seconds. The 
initial value is 600. 

IS .CONFIGURATION JTIMER (ICT) 

Changes the value of the configuration timer used to control the rate at 
which an intermediate system transmits Intermediate System Hello PDUs. 
A higher value reduces the CPU overhead but increases the time it takes 
other systems to learn about a new intermediate system or loss of a 
currently known intermediate system. Control Data recommends that a 
small value be used for this timer. The value is specified in seconds. The 
initial value is 60. 

ROUTING .CACHE .INACTIVITY JTIMER (RCIT) 

Changes the value of the inactivity timer used to time out entries in the 
routing cache in an end system. A lower value for this timer increases the 
CPU overhead but deletes inactive entries sooner; therefore minimizing 
memory use. The value is specified in seconds. The initial value is 300. 

ENABLE .CHECKSUM (EC) 

Enables or disables generation of the checksum for ES-IS Routing PDUs 
transmitted by the local system. The initial value is FALSE. 

CONS ROUTING .SUPPORT (CRS) 

Enables or disables the routing support for CONS. In intermediate or 
combined systems, it is used to enable or disable the software needed to 
support the relay function for CONS. 

When the value of this option is changed from FALSE to TRUE, the 
software needed to support the relay function for CONS is loaded and 
started. This includes CONS IWU (CONS Interworking Unit), CONS, LLC 
2 (Logical Link Control 2), and X.25 PL (X.25 Packet Level) software. 
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NOTE 



It is possible that CONS, LLC 2, and X.25 PL software may already be 
loaded and started in order to support Transport over CONS (see the 
CHANGE _OSI .TRANSPORT command) or for X.25 PL, due to a 
DEFINE _X25 .INTERFACE command. 



When the value of this option is changed from TRUE to FALSE, CONS 
IWU quits using CONS to establish new connections. However, the existing 
connections over CONS are not affected. After all existing connections over 
CONS terminate, the software used to support the relay function for CONS 
stops and is made deloadable. However, CONS and LLC 2 are not stopped 
if they are needed to support Transport. X.25 PL is not stopped if it is 
needed to support Transport or if a DEFXI had previously been executed. 

The initial value is FALSE. 

ENABLE CONFIGURATION JSfOTIFY (ECN) 

Enables or disables the configuration notification function of the ES-IS 
protocol. If enabled, it allows for rapid configuration of the routing 
database on a system that is initializing. The main disadvantage of 
enabling is that there may be cases when all the systems on an ESCI 
network flood the system being "helped" with ES-IS PDUs. 

If this function is disabled, configuration may be delayed. The initial value 
of this parameter is TRUE. 

Responses The following header precedes the routing options message. 

ES-IS Routing options are changed. 

Routing Function was already <routing_function>. 
CONS Routing Support was already enabled. 
CONS Routing Support was already disabled. 

The following header is a success response. 

ES-IS Routing options are changed. 

The following messages are error responses. 

-ERROR- ES-IS Routing Options cannot be updated. CONS was unable 
to open an X.25 Packet Level SAP. 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks CONS rejects all incoming calls requesting reverse charging. 

If CONS is loaded and started, X.25 PL sends all incoming calls with no 
user data to CONS. If CONS is not loaded and started, X.25 PL sends all 
incoming calls with no user data to the X.25 PL user (potential users are 
X.25 Gateway, X.25 Network) that has defined a protocol ID of 0. 
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If a MAC-level bridge is used to connect two LLC 2 endpoints (for 
example, two CDCNET systems connected via an Ethernet bridge), then 
the bridge must ensure FIFO ordering, even if it utilizes multiple HDLC 
trunks. The LLC 2 protocol requires the underlying layers to preserve 
FIFO ordering. 

CONS must be configured in every device between the source and 
destination endpoints of the associated OSI application. If there are 
multiple paths available, CONS must be configured in every device in each 
path. For example, if a NOS/VE host has two NOS/VE MDIs connected to 
a common Ethernet leading to an NDI with CONS configured, both 
NOS/VE MDIs must have CONS configured. 

Examples change_es1s_rout1ng_options ect - 60 
ES-IS Routing options are changed. 



change_es1s_rout1ng_options rf=ES ect = 60 crs=false 

ES-IS Routing options are changed. 
Routing function was already ES. 
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CHANGE JNAME_RESOLVER (CHANR) 
NETOU Command 

Purpose Changes any or all parameters specified in the DEFNR command. You do 
not need to cancel the Domain Name Resolver (DNR) first. Any parameter 
not reentered is not modified. 

Format CHANGE _NAME _RESOLVER 

DOMAIN J^AME = string 1.255 

SERVER _M>DRESSES = list 1..4 of 4 of integer 0.255 

RETRYJLIMIT = integer 0..256 

RETRYJTIMER = integer 1..32 

Parameters DOMAIN JKTAME (DN) 

Defines the name of the local administrative domain for the DNR. When 
requested to obtain information about a name and the name is a simple 
domain label, the DNR appends the DOMAIN _NAME parameter to the 
label before querying a Domain Name Server (DNS). 

SERVER .ADDRESSES (SA) 

Defines the order in which to query the IP addresses of the DNSs. The IP 
addresses are used in the order in which they are entered to communicate 
with the DNSs. At least one address is required which becomes the 
primary DNS. Up to three additional addresses may be entered specifying 
the secondary DNS. 

RETRYJLIMIT (RL) 

Defines the maximum number of times that a query is reissued over UDP. 

RETRYJTIMER (RT) 

Defines the timeout value used for UDP datagrams. It is used to reissue a 
UDP datagram if no response is received within the RETRYJTIMER 
period. Also, it is the value used to timeout a request if the application 
has not specified a timeout value. 

Responses The TCP/IP Name Resolver is changed. 

-ERROR— Domain Name Resolver is not defined. 

-ERROR— Domain _name cannot contain the character < character >. 
Domain _name can only contain the characters A-Z, a-z, 0-9, hyphen (-) and 
underscore (_). 

-ERROR- A domain .name label is too long. Each label cannot be greater 
than 63 characters. 



-ERROR- UDP is not defined. 

Examples change_name_resolver doma1n_name ■ 
server.address ■ ((129,179,60,48) 



'arh-cdc-com' 
(GRAY) 



(129.179,52,203) 
(129,179,48,30)) 
retry_limit = 5 
retry_t1mer ■ 10 



(ROYAL) 
(ODEON) 



The TCP/IP Name Resolver Is changed. 
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CHANGE _OSIJTRANSPORT (CHAOT) 
NETOU Command 

Purpose Changes various operating characteristics of the OSI Class 4 and where 

applicable, Class Transport. These changes (from the first 4 parameters) 
affect connection establishment and apply only to connection establishment 
subsequent to command execution. 

Format CHANGE _OSI .TRANSPORT 

CHECKSUMMING = boolean 

ACKNOWLEDGE JTIMER = 0..30 

MAXIMUM _WINDOW_SIZE = 1..16 

MAXIMUM ..CONNECTIONS = 0.. 65535 or INFINITE 

ENABLE _OVER_CONS = boolean 

CONS_USERJDATA = 2.J32 or NONE 

Parameters CHECKSUMMING (C) 

Determines how checksumming use is negotiated during connection 
establishment. This occurs for both incoming and outgoing connections, but 
does not apply to connections already established. 

If the value is TRUE, the transport entity negotiates for checksumming; 
the peer must agree or disconnect. 

If the value is FALSE, the transport entity attempts to negotiate not to 
use checksumming. 

However, the peer may insist on checksumming. For example, if the peer 
resides in another DI that has this parameter set to TRUE, checksumming 
is performed. Checksumming prevents data corruption by certain types of 
errors, but increases processor load. 

Initial value is FALSE. 

ACKNOWLEDGE JTIMER (AT) 

Represents the boundary for the maximum time that elapses between the 
receipt of a TPDU by the local transport entity, and the transmission of 
the corresponding acknowledge (ACK) TPDU. This value is sent to the peer 
during connection establishment. 

A larger value for the acknowledge timer increases buffer use in systems 
that establish connections with the local system. This is because the 
sending transport must retain a copy of each message sent longer in case 
retransmission is necessary. However, the larger value lowers network and 
processor load by including acknowledges with other acknowledges, and 
reverse direction data messages. The effect is application-dependent with 
factors such as full-duplex versus half-duplex, or application "think" time. 

Initial value is 5 seconds. 
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MAXIMUM _WINDOW_SIZE (MWS) 

Specifies the upper boundary of user-specified transport window size. 
Transport users may specify maximum window size at connection 
establishment time. You can lower the initial value to save memory per 
connection. However, this increases network and processor load. A lower 
value decreases throughput on connections limited by the configured 
window size. A lower value can indirectly increase throughput on other 
connections by throttling connections limited by window size. 
Initial value is 16. 

MAXIMUM ..CONNECTIONS (MC) 

Maximum simultaneous OSI transport connections. If the value is 
INFINITE, there is no restriction on the number of connections other than 
the limitation imposed by physical memory available. It may be desirable 
to lower the initial value to reserve memory for executing status command 
processors and configuration changes. However, lowering this value also 
reduces the number of simultaneous terminal connections and file transfers. 
Initial value is INFINITE. 

ENABLE _OVER _CONS (EOC) 

Controls the support of transport service over CONS. When TRUE is 
specified, service is supported. 

When the value is changed from FALSE to TRUE, the software needed to 
support this service is loaded and started. This includes class transport, 
CONS, Logical Link Control 2 (LLC2), and X.25 Packet Level (X.25 PL) 
software. 

NOTE 



CONS, LLC2, and X.25 PL software may have previously been loaded and 
started by the DEFXI command in order to support CONS interworking 
unit or the X.25 PL. 



When the value of this parameter is changed from TRUE to FALSE, 
Transport software quits using CONS to establish new connections. 
However, existing connections remain unaffected. When all connections are 
terminated, software is stopped and is made deloadable. 



NOTE 



CONS, LLC2, and X.25 PL are not stopped if they are needed to support 
the CONS interworking unit, or the X.25 PL, due to a DEFXI command 
previously executed. 



Initial value is FALSE. 

CONS _USER JDATA (CUD) 

Specifies the user data to be submitted to CONS on a connection request. 
The value must be a string containing an even number of hexadecimal 
digits or the keyword NONE. 
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A common use of CONS_USER_DATA among various vendors is to use 
the Network Management Connection Subprotocol (NMCS) UN PDU that 
signifies that the X.25 connection is dedicated for use by OSI Transport. 
This PDU is '03010100', four bytes long. The first byte, '03', is used as the 
protocol id. The DI version of CONS is set up to handle incoming X.25 
connect requests destined for protocol id 3 or the null protocol id. 

Initial value is NONE. 

Responses The following headers are success responses. 

OSI Transport is changed. 

OSI Transport is changed. (Precedes one of the following lines) 

Transport service over CONS was already enabled. 
Transport service over CONS was already disabled. 

The following are responses are error messages. 

-ERROR- Unable to change OSI Transport, enable over CONS = true 
due to CONS unable to open an X.25 Packet Level SAP. 

-ERROR- The CONS user data <cons_user_data> contains 
non-hexadecimal characters. 

-ERROR- The CONS user data <cons_user_data> contains an odd 
number of digits. 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks CONS rejects all incoming calls requesting reverse charging. 

If CONS is loaded and started, X.25 PL sends all incoming calls with no 
user data to CONS. If CONS is not loaded and started, X.25 PL sends all 
incoming calls with no user data to the X.25 PL user. 

CONS must be configured in every device between the source and 
destination endpoints of the associated OSI application. If there are 
multiple paths available, CONS must be configured in every device in each 
path. For example, if a NOS/VE host has two NOS/VE MDIs connected to 
a common Ethernet leading to an NDI with CONS configured, both 
NOS/VE MDIs must have CONS configured. 

Examples change_os1_transport c=TRUE 
OSI Transport Is changed. 
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CHANGE _OUTCALL .GATEWAY (CHAOG) 
NETOU Command 

Purpose Changes the outcall gateway default inactivity timer value. The timer 
value is specified in seconds. 

Format CHANGE _OUTCALL .GATEWAY 

INACTIVITY JTIMER = 120. .14400 or INFINITE 

Parameters INACTIVITY JTIMER (IT) 

Adjusts the default inactivity timer. Users who do not transmit or receive 
data for a time period equal to this parameter's value are disconnected 
from the server and the server is made available to other users. 

Responses Change of Outcall Gateway is accepted. 

-ERROR- Outcall Gateway is not defined. 
Examples change_out call .gateway it=3Q0 

Change of Outcall Gateway is accepted. 
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CHANGE _PASSTHROUGH .SERVICE (CHAPS) 
NETOU Command 

Purpose Changes the passthrough default inactivity timer. 
NOTE 



In future releases, this command will no longer be supported. You should 
start using the CHANGE _OUTCALL_GATEWAY command as soon as 
possible. 

Format CHANGE .PASSTHROUGH .SERVICE 

INACTIVITY JTIMER = 120..14400 or INFINITE 

Parameters INACTIVITY JTIMER (IT) 

The inactivity timer measures the time during which no data is sent in 
either direction over a paired passthrough connection. This parameter 
specifies the maximum time, in seconds, a passthrough connection can be 
idle. When the time specified by this parameter (or the default value) 
expires, the passthrough connection to the terminal user disconnects. The 
newly selected timer value affects new as well as existing connections that 
use the default timer. The timer value is specified in units of seconds 
(range of 120..14400). Initial value is INFINITE. 

Responses Change of Passthrough Service accepted. 

—ERROR— Passthrough Service not defined. 



Examples change_passthrough_ service 1t=300 



Change of Passthrough Service accepted. 
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CHANGE .PRINTER _MODEL .ATTRIBUTES (CHAPMA) 
DI Configuration Procedure/NETOU Command 

Purpose Changes printer attributes previously set by a DEFINE .PRINTER. 

MODEL .ATTRIBUTES command for a specific printer terminal model. 
CHANGE .PRINTER .MODEL.ATTRIBUTES can be specified in a DI 
configuration file or via NETOU. There are no defaults for this command's 
parameters. If you do not specify a parameter, its value is left unchanged. 

Format CHANGE .PRINTER MODEL ATTRIBUTES 

TERMINAL .MODEL = name 

AUTO _PAGE JSJECTJCHANNEL = 2. .12 
CHANNEL _J_SEQUENCE = list 1..7 of <ccode> 
CHANNEL _2 SEQUENCE = list 1..7 of <ccode> 
CHANNEL _3_SEQUENCE = list 1..7 of <ccode> 
CHANNEL _4_SEQUENCE = list 1..7 of <ccode> 
CHANNEL .5 _SEQUENCE = list 1..7 of <ccode> 
CHANNEL _6_SEQUENCE = list 1..7 of <ccode> 
CHANNEL _7_SEQUENCE = list 1..7 of <ccode> 
CHANNEL _8 _SEQUENCE = list 1..7 of <ccode> 
CHANNEL _&JSEQUENCE = list 1..7 of <ccode> 
CHANNEL _10 ..SEQUENCE = list 1..7 of <ccode> 
CHANNEL _11 _SEQUENCE = list 1..7 of <ccode> 
CHANNEL _12 _SEQUENCE = list 1..7 of <ccode> 
FORM _FEED J3ELAY = 0..3000 
FOLDJLINE = boolean 

FORM _FEED _SEQUENCE = list 1..7 of <ccode> 
KEYBOARD = boolean 

NO JSPACE _SEQUENCE = list 1..7 of <ccode> 
SINGLE _SPACE _DELAY = 0..1000 
SINGLE _SPACE _SEQUENCE = list 1..7 of <ccode> 
BOTTOM _OF_FORM_CHANNEL = 2..12 
VFU_TOP_FORM = boolean 
MAXIMUM _VFU .LENGTH = 0..255 
INITIALIZATION PROCEDURE = name 
INITIALIZATION _SEQUENCE = list 1..31 of <ccode> 
EIGHT _LPI_SEQUENCE = list 1..7 of <ccode> 
FILE _PREFIX .PROCEDURE = name 
FILE JPREFIX _SEQUENCE = list 1..31 of <ccode> 
FILE ^SUFFIX _SEQUENCE = list 1..31 of <ccode> 
SIX JJPIJSEQUENCE = list 1..7 of <ccode> 

NOTE 



For character code (ccode) values, see of the CDCNET Configuration Guide. 

Parameters TERMINAL .MODEL (TM) 

The 1- through 31-character name of the printer terminal model for which 
attributes are being defined. This parameter may not be the same as any 
terminal model already defined by Control Data. It must have already been 
specified in a DEFINE .PRINTER .MODEL .ATTRIBUTES command. 
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AUTO_J>AGE^EJECT_CHANNEL (APEC) 

Supported by ASYNC, X.25 asynchronous, and URI TEPs only. Channel 
causing the printer to skip automatically to the next top-of-form channel. 
May not be the same as BOTTOM _OF_FORM_CHANNEL (BOFC) value. 

CHANNEL _J .SEQUENCE (CIS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "8" or "H" format effector is recognized in 
output lines. 

CHANNEL _J_SEQUENCE (C2S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "7" or "G" format effector is recognized in 
output lines. 

CHANNEL _3 _SEQUENCE (C3S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "6" or "F" format effector is recognized in 
output lines. 

CHANNEL _4JSEQUENCE (C4S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "5" or "E" format effector is recognized in 
output lines. 

CHANNEL J5J3EQUENCE (C5S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "4" or "D" format effector is recognized in 
output lines. 

CHANNEL _6_SEQUENCE (C6S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "3" or M C" format effector is recognized in 
output lines. 

CHANNEL _7 _SEQUENCE (C7S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "9" or "I" format effector is recognized in 
output lines. 

CHANNEL J3JSEQUENCE (C8S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "X M or "J" format effector is recognized in 
output lines. 

CHANNEL _9_SEQUENCE (C9S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "Y" or "K" format effector is recognized in 
output lines. 

CHANNEL _10 SEQUENCE (C10S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "Z" or "L" format effector is recognized in 
output lines. 
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CHANNEL _11 JSEQUENCE (CHS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "W" or "M" format effector is recognized in 
output lines. 

CHANNEL _12_SEQUENCE (C12S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "U" or "N" format effector is recognized in 
output lines. 

FORM _FEED JDELAY (FFD) 

Supported by ASYNC and X.25 asynchronous TIPs only. Milliseconds 
(maximum 3000) the TIP must delay after sending a CHANNEL _x_ 
SEQUENCE or FORM _FEED .SEQUENCE to the printer. The TIP sends 
null characters to the device to effect the delay. 

FOLD_X,INE (FL) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Indicates if 
the TIP must fold lines longer than the device page width. 

FORM _FEED _SEQUENCE (FFS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "1" or "A" format effector is recognized in 
output lines. 

KEYBOARD (K) 

Supported by ASYNC and X.25 asynchronous TIPs only. Indicates if the 
printer has an associated keyboard. 

If an asynchronous printer is configured with a keyboard, you can use the 
keyboard to enter the following commands to control the printer: DROP, 
START, and STOP. See the CDCNET Batch Device User's Guide for more 
information on these commands. 

NO _SPACE SEQUENCE (NSS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a " + " format effector is recognized in output 
lines. 

SINGLE _SPACE J)ELAY (SSD) 

Supported by ASYNC and X.25 asynchronous TIPs only. Milliseconds 
(maximum 1000) the TIP must delay after sending a SINGLE _SPACE _ 
SEQUENCE to the printer. The TIP sends null characters to the device to 
effect the delay. 
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SINGLE _SPACE .SEQUENCE (SSS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when one of the following format effectors is recognized 
in output lines: 

Format Effector Times Single Space Sequence Sent 

" " (blank; single One 

space) 

"0" (double space) Two 

"-" (triple space). Three 

BOTTOM jOFJFORMjCHANNEL (BOFC) 

Channel to skip to when a "2" or "B" format effector is recognized in 
output lines. May not be the same as AUTO_PAGE _EJECT_CHANNEL 
(APEC) value. 

VFU JTOPJFORM (VTF) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Defines 
whether of not the printer must be at top-of-form when the VFU is loaded. 

MAXIMUM _VFU .LENGTH (MVL) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Maximum 
lines the printer supports in a VFU load image. 

INITIALIZATION PROCEDURE (IP) 

Name of the load procedure containing data output to the printer when the 
line activates. Supported for any TIP handling transparent data. 

INITIALIZATION SEQUENCE (IS) 

Sequence of octets sent to the printer when the printer activates and can 
receive output. If an initialization procedure is specified, the initialization 
sequence is sent after procedure data. Supported for any TIP handling 
transparent data. 

EIGHT _LPI_SEQUENCE (ELS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "T" format effector is recognized in output 
lines. This parameter is allowed only if the DEFBD command for the 
printer has the parameter value VFU _LOAD_OPTION= NONE. 
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Remarks 



FILE JPREFIX PROCEDURE (FPP) 

Name of the load procedure containing data output to the printer before 
each nontransparent file. Supported for any TIP handling transparent data. 



NOTE 



If you change an FPP, do the following to guarantee that all printers and 
printer terminal models using the FPP get a copy of the changed FPP: 

for each printer terminal model that uses the FPP, send a CHANGE 
PRINTER .MODEL .ATTRIBUTES command to the DI or DIs supporting 
the printers. Specify the TERMINAL .MODEL and FILE .PREFIX. 
PROCEDURE parameters. For more information, see the CDCNET* 
Configuration Guide. 



FILE .PREFIX J3EQUENCE (FPS) 

Sequence of octets sent to the printer before each file. If a file prefix 
procedure is specified, the file prefix sequence is sent after procedure data. 
Supported for any TIP handling transparent data. 

FILE_SUFFIX_SEQUENCE (FSS) 

Sequence of octets sent to the printer after each file. Supported for any 
TIP handling transparent data. 

SIX _LPI _SEQUENCE (SLS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "S" format effector is recognized in output 
lines. This parameter is allowed only if the DEFBD command for the 
printer has the parameter value VFU_LOAD_OPTION=NONE. 

Responses Printer model <name> changed. 

-ERROR- Cannot locate the specified printer terminal model. 

-ERROR- Printer model <name> is CDC defined-it cannot be modified. 

-ERROR- The bottom of form and auto page eject channels cannot be the 
same. 

-ERROR- If EIGHTJLPI .SEQUENCE or SIX _LPI .SEQUENCE is 
specified, then both must be specified. 

If an EIGHT.LPI .SEQUENCE or a SIX _LPI .SEQUENCE is defined for 
a printer terminal model, both must be specified. These sequences may 
only be used for printers defined with the DEFINE .BATCH .DEVICE 
parameter value VFU .LOAD .OPTION = NONE. 

change_pr 1 nt er_mode 1 _at t r 1 but es tm=user _pr 1 nter_mode 1 . . 
fold_Hne=true 



Examples 



Printer model user_pr Inter .model changed. 
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CHANGE _SERVERJTELNET_GW (CHASTG) 
NETOU Command 

Purpose Changes the operational parameters of a server TELNET gateway. The 

original values for these parameters were specified (or defined as defaults) 
in the DEFINE _SERVER_TELNET_GW command. Any changes specified 
affect only new connections to the gateway; existing connections are not 
affected. 

Format CHANGE _SER VER _TELNET_GW 

GATEWAY_NAME = name 

IP^ADDRESS = list 4 of 0.255 

TITLE = name 

TRANSLATION JDOMAIN = CATENET 

MAX CONNECTIONS = 0..65535 or INFINITE 

TCPJ>ORT_NUMBER = 0..65535 

TCP .ALLOCATE _SIZE = 0..2147483647 

TCPJTIMEOUT = 0..65535 or INFINITE 

INACTIVITY JTIMEOUT = 0..65535 

Parameters GATEWAY.NAME (GN) 

The logical name of the server TELNET gateway used in subsequent 
commands that reference the gateway. 

IP_ADDRESS (IA) 

The IP address of the host for which this gateway provides server 
TELNET terminal service. The format is similar to the decimal octet 
convention used by the TCP/IP community, except that the periods are 
replaced with commas, and the list is enclosed in parentheses. For 
example, the IP address 128.2.53.7 is represented as (128,2,53,7). 

TITLE or TITLES (T) 

Specifies the title that this gateway translates to locate the service 
provider. If the destination system is NOS, this title must be from the 
DEFINE _NP_TERMINAL_GW command. If the destination system is 
NOS/VE, this title must be the one registered by the terminal manager. 

TRANSLATION J>OMAIN (TD) 

Specifies the portion of the CDCNET catenet that should be searched for 
the service corresponding to the title information given in the TITLE 
parameter. The only supported value is CATENET. 

MAX CONNECTIONS (MC) 

Specifies the maximum number of simultaneous connections to be supported 
by the gateway. If INFINITE is entered, there is no restriction to the 
number of connections allowed. 

TCP_PORT_NUMBER (TPN) 

Specifies the TCP port number to be used by the gateway. Server TELNET 
issues a TCP PASSIVE .CONNECT request using the well-known port for 
the source port. Initial value is the well-known server TELNET port 23. 
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TCP ^ALLOCATE J3IZE (TAS) 

Specifies the amount of data that the gateway queues for each connection. 
Larger values might improve user response time, especially for PC users 
(with a standard protocol such as XMODEM), but might also increase the 
number of instances of DI congestion. 

CAUTION 



Changing this value is discouraged, and should be done with caution, as 
network service may be disrupted. 



Responses 



Examples 



TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of data transmission. If an acknowledgment is not received 
within the specified period, TCP aborts the connection. A small value (less 
than a few seconds) might cause frequent and unnecessary loss of service 
during periods of network congestion. A large value might leave users 
waiting a long period of time after a host or network has failed. If 
INFINITE is entered, the connection never aborts. 

INACTIVITY JTIMEOUT (IT) 

Specifies the interval (in seconds) between inactivity checks. If a connection 
has been idle for the specified time, the gateway sends a TELNET status 
request to the remote TELNET to determine if the connection is still 
usable. 

Server TELNET gateway < gateway _name> is changed. 

-ERROR- Server TELNET gateway < gateway _name> is not defined. 

change_server_telnet_gw gateway_name=gw_to_cyber .. 
1 1 1 1 e=i vt .gateway max.connect lons-5 

Server TELNET gateway GW_TO_CYBER is changed. 
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CHANGE .SERVICE .DISPLAY (CHASD) 

DI Configuration Procedure/NETOU Command 

Purpose Manages service list shown in the service availability display. Effects of 

multiple change commands is cumulative. The initial service list is empty; 
that is, if no CHANGE .SERVICE .DISPLAY command is entered, no 
services are displayed when users enter the DISPLAY_SERVICES 
command. 

Format CHANGE .SERVICE .DISPLAY 

ADDJSERVICES = list 1..16 of name 

DELETE .SERVICES = list 1..16 of name or ALL 

STATUS INTERVAL = 1..60 or INFINITE 

Parameters ADDJSERVICES or ADD JSERVICE (AS) 

List of interactive service names (for example, NOS or NOS/VE, 
passthroughs) to add to the service availability display. 

DELETE JSERVICES or DELETE JSERVICE (DS) 

List of interactive service names to delete from the service availability 
display. If a service is specified on both ADD .SERVICES and DELETE. 
SERVICES, the DELETE .SERVICES parameter takes precedence. ALL 
specifies to delete all services from the list. 

STATUS JNTERVAL (SI) 

How often the status of services in the service availability display is 
updated. 

The status of each displayable service is updated when a user enters the 
first DISPLAY.SERVICES command. A CREATE .CONNECTION command 
also updates status of a displayable service. If STATUS .INTERVAL has 
not expired, status of a displayable service is not updated when the next 
DISPLAY.SERVICES command is entered. The interval is in units of 
minutes. Initial value is 5 minutes. 

INFINITE specifies that the interval never expires; the status of a service 
is updated only when a CREATE .CONNECTION command is entered. 

CREATE .CONNECTION updates status only for the service name 
specified on CREATE .CONNECTION. That is, if a service has alternative 
names, their status is not automatically updated. As a result, conflicts in 
the status of an interactive service known by multiple names can occur 
when the service status is displayed. 
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Responses Services added to the displayable list. 

< service _name > 

< service _name > 

Services deleted from the displayable list. 

< service _name > 

< service _name > 

-ERROR- Service < service _name> not in displayable list. 

-ERROR- Service < service _name> already in displayable list. 

-ERROR- No services defined in displayable list. 

-FATAL- Insufficient resources to change displayable list. 

Remarks Executing the DISS command can cause excessive traffic in larger network 
configurations. When traffic becomes to excessive, status of some of the 
displayable services may not be reported. 

One method used to reduce network traffic is to configure no more than 
three displayable services in each TDI. 

Another method used to reduce network traffic is to use the keyword value 
INFINITE on the STATUS .INTERVAL parameter of the CHASD command. 
This keyword value instructs the DISPLAY_SERVICES command to not 
use the CDCNET directory services to obtain the status of displayable 
services. (Using the directory services causes the congestion problem.) 

When INFINITE is used, all services can be displayed safely. However, 
using INFINITE reduces accuracy of the reported status, because status of 
displayable services is only updated based on success or failure of users' 
CREATE .CONNECTION attempts for the services. 

Examples change_serv1ce_d1splay add_service=veiaf 
Services added to the displayable list, 
veiaf 
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CHANGE .SERVICE JDISPLAY JTEXT (CHASDT) 
DI Configuration Procedure/NETOU Command 

Purpose Defines text shown in the service availability display. This text is 

displayed when a terminal user enters the DISPLAY_SERVICES command. 
If multiple services are specified, the same information applies to each 
service. You must specify at least one of the optional text parameters to 
change the text displayed for a service. 

Format CHANGE ..SERVICE ^DISPLAY JTEXT 

SERVICE = list 1..16 of name or ALL 

TEXT = list 1..4 of string 1..72 
DOWNJTEXT = list 1..4 of string 1..72 
TEMPORARY JDOWN JTEXT = list 1..4 of string 1..72 

The TEXT, DOWNJTEXT, and TEMPORARY_DOWN JTEXT parameter 
definitions imply each value can be four 72- character strings. Since 
CDCNET commands are restricted to 256 characters, it is not possible to 
use the full range of these parameters. The TEXT, DOWNJTEXT, and 
TEMPORARY_DOWN JTEXT parameters for the same service name can be 
specified on separate CHASDT commands. 

Parameters SERVICE or SERVICES (S) 

List of interactive service names for which the text applies. ALL specifies 
the text applies to all interactive services. 

TEXT (T) 

Text displayed if a service is up or busy. This text appears if the service 
is down and no DOWNJTEXT or TEMPORARY_DOWN JTEXT is defined. 
There can be up to four lines of text. 

DOWNJTEXT (DT) 

Text displayed when a service is down. There can be up to four lines of 
down text. It appears only if no TEMPORARYJDOWN JTEXT is defined. 

TEMPORARY _J)OWN JTEXT (TDT) 

Text displayed when a service is down. There can be up to four lines of 
temporary down text. It is deleted when the service status changes from 
down to up. One use of this parameter is to send CHASDT through 
NETOU to enter messages for down services. 
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Responses Services information changed for services. 

< service _name > 

< service _name > 

-ERROR- At least one text parameter must be specified to cause the 
service display text to be changed. 

-ERROR- Service < service _name> not in displayable list. 

-ERROR- No services defined in displayable list. 

-FATAL- Insufficient resources to change displayable list. 

Examples change_service_d1splay_text serv1ce=velaf . . 

text='Call ext. 9111 if you are having problems.' 

Services Information changed for services. 

velaf 
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CHANGE _SNMP_AGENT (CHASA) 
NETOU Command 

Purpose Changes operational parameters for the Simple Network Management 
Protocol (SNMP) agent. Only CDCNET allows commands of length less 
than 256. You can execute CHANGE _SNMP__AGENT as many times as 
needed to ensure all variables fit on the command line. SNMP Managers 
granted read-write access can also modify values. 

Format CHANGE _SNMP_AGENT 

NAME = string 1.226 

CONTACT = string 1.226 

LOCATION = string 1.226 

MAX _J>DU _SIZE = integer 484..8192 

Parameters NAME (N) 

Specifies the administratively assigned name for this communications 
device. 

CONTACT (C) 

Specifies the contact person for this communications device, together with 
information on how to contact the person. 

LOCATION (L) 

Specifies the physical location of this communication device. 

MAXJPDU_SIZE (MPS) 

Specifies the maximum size PDU that an SNMP agent builds and sends to 
the peer SNMP Manager. 

Responses The SNMP Agent has been changed. 

-ERROR- Source log group <name> is not defined. 

—WARNING— No message numbers specified. 

-WARNING- The SNMP Agent has not been changed. No parameters were 
specified. 

-WARNING- The SNMP Agent is not defined. Source log group changed. 

Examples change.sninp.agent location»'Arden Hills, room 2N150' 

The SNMP Agent has been changed. 
change_snmp_agent 

— WARNING— The SNMP Agent has not been changed. No parameters were specified, 
change.snmp.agent location*' locked shortlook configuration' 

— WARN1NS-- The SNMP Agent is not defined. 
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CHANGE _SOURCE _LOG _GROUP (CHASLG) 
DI Configuration Procedure/NETOU Command 

Purpose Changes the log messages defined for log group to which a DI's Dependent 
Log ME belongs. All log message numbers specified by the ADD_ 
MESSAGE ..NUMBER parameter are defined and then all log message 
numbers specified by the DELETE .MESSAGE ^NUMBER parameter are 
cancelled. Changes made by this command remain in effect until the next 
DI reload. 

Format CHANGE .SOURCE _LOG _GROUP 

LOGjGROUP = name 

ADD .MESSAGE DUMBER = list 1..63 of range 1.. 32999 

DELETE MESSAGE .NUMBER = list 1..63 of range 1..32999 

Parameters LOGjGROUP (LG) 

Specifies the log group changed by this command. This is the log group to 
which the defined log messages belong. For this release of CDCNET, only 
one source log group can be defined per DI. Initial value is CATENET. 

ADD .MESSAGE J^UMBER (AMN) 

Specifies one or more log message numbers to be defined for the log group 
specified. For log messages and their numbers, see the online Diagnostic 
Messages manual. 

DELETE ^MESSAGE _NUMBER (DMN) 

Specifies one or more log message numbers to be cancelled for the log 
groups specified. For log messages and their numbers, see the online 
Diagnostic Messages manual. 

Responses Source log group changed. 

—WARNING— No message numbers specified. 

—ERROR- Source log group <name> is not defined. 
Examples change_source_log_group amn=(40,346,500) 

Source log group changed. 



change_source_1og_group dmn=346 
Source log group changed. 
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CHANGE ^SYSTEM (CHAS) 

DI Configuration Procedure/NETOU Command 

Purpose Changes the value of several parameters on the DEFINE _SYSTEM 

command. Changes memory and buffer allocation boundaries for a DI's 
memory management functions. Changes whether the system broadcasts 
IS-IS routing protocol data units or provides the catenet master clock 
through the Independent Clock ME. Changes the maximum number of 
recoveries before resetting the DI. 

For DIs connected to a NOS host, this command also provides the master 
clock for the catenet through the Independent Clock ME. Finally, the 
command changes the maximum number of recoveries allowed before 
resetting the DI. 

If CHANGE _SYSTEM is included in a DI configuration procedure, a 
DEFINE _SYSTEM command must precede it. Using NETOU, however, you 
can enter a CHANGE .SYSTEM command for a DI that does not have a 
DEFINE _SYSTEM command in its configuration file. 

All changes except for the DATA_BUFFER_SIZE and RESERVED. 
SYSTEM _SPACE become effective immediately. Changes for these 
parameters become effective at the next system load. All changes remain 
in effect when a DI is reloaded, and stay in effect until you change them 
again. 

Format CHANGE .SYSTEM 

DATA_BUFFER _SIZE = 64.2304 

BUFFER _BOUNDARY ^PERCENTAGE = list 1.3 of 1..99 

MEMORY BOUNDARY PERCENTAGE = list 1.3 of 1..99 

MEMORY _MANAGER_J>ERIOD = 1..10 

RESERVED _SYSTEM JSPACE = 1000.32768 

STANDARD _STACK _SIZE = 2048..8192 

DEFAULT JCHANNEL JTRUNK = name 

ROUTING _SYSTEM = boolean 

CLOCKING _SYSTEM = boolean 

MAXIMUM RECOVERIES = 0..255 

COMPRESS _DUMP = boolean 

Parameters DATA _BUFFER _$IZE (DBS) 

Size, in bytes, of the system data buffers. The value of this parameter is 
stored in battery-backed non-volatile memory and the effects are not 
realized until a reset other than a power- on reset occurs. 

The actual buffer size saved is adjusted to be a multiple of a descriptor 
buffer. The following table defines the actual buffer sizes generated for 
ranges of entered data buffer size values. 
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DBS 


Buffer 


DBS 


Buffer 


Value 


Size 


Value 


Size 


64.70 


68 


1173..1210 


1208 


71..108 


106 


1211..1248 


1246 


109..146 


144 


1249..1286 


1284 


147..184 


182 


1287.. 1324 


1322 


185..222 


220 


1325..1362 


1360 


223..260 


258 


1363.. 1400 


1398 


261..298 


296 


1401..1438 


1436 


299..336 


334 


1439..1476 


1474 


337..374 


372 


1477..1514 


1512 


375..412 


410 


1515..1552 


1550 


413..450 


448 


1553..1590 


1588 


451..488 


486 


1591..1628 


1626 


489.J26 


524 


1629..1666 


1664 


527..564 


562 


1667..1704 


1702 


565..602 


600 


1705..1742 


1740 


603..640 


638 


1743..1780 


1778 


641..678 


676 


1781..1818 


1816 


679..716 


714 


1819..1856 


1854 


717..754 


752 


1857..1894 


1892 


755..792 


790 


1895..1932 


1930 


793..830 


828 


1933..1970 


1968 


831..868 


866 


1971..2008 


2006 


869..906 


904 


2009..2046 


2044 


907.. 944 


942 


2047..2084 


2082 


945..982 


980 


2085..2122 


2120 


983..1020 


1018 


2123..2160 


2158 


1021..1058 


1056 


2161..2198 


2196 


1059..1096 


1094 


2199..2236 


2234 


1097..1134 


1132 


2237..2274 


2272 


1135..1172 


1170 


2275..2304 


2310 



Default is 144 for a DI with less than 4 megabytes of SMM and 524 for an 
ICA-II with 4 or more megabytes of SMM (set at power-up but can be 
altered if this parameter is specified). 

BUFFER _BOUNDARY_PERCENTAGE (BBP) 

Percentages of available buffers corresponding to boundaries between 
different states of DI buffer availability. The DI dynamically maintains the 
state of available buffers. The four defined buffer states are: GOOD, FAIR, 
POOR, and CONGESTED. 

Specify a list of three integers that specify the three boundaries between 
the four buffer states. The first value defines the boundary value between 
GOOD and FAIR; the second value defines the boundary between FAIR and 
POOR; the third value defines the boundary between POOR, and 
CONGESTED. Values must be listed from highest value to lowest, and 
differ by at least 5. 



60000414 C CHANGE Commands 5-31 



CHANGE_SYSTEM (CHAS) 



MEMORY BOUNDARY PERCENTAGE (MBP) 

Percentages of available memory that correspond to boundaries between 
different states of DI memory availability. The DI dynamically maintains 
the state of available memory. The four defined memory states are: GOOD 
FAIR, POOR and CONGESTED. 

Specify a list of three integers that specify the three boundaries between 
the four memory states. The first value defines the boundary value 
between GOOD and FAIR; the second value defines the boundary between 
FAIR and POOR; the third value defines the boundary between POOR and 
CONGESTED. Values must be listed from highest to lowest, and differ by 
at least 5. 

MEMORY JAANAGER _PERIOD (MMP) 

Interval, in seconds, that the DI memory manager executes to maintain the 
DI buffer and memory state. 

RESERVED _SYSTEM J5PACE (RSS) 

Number of bytes to be reserved in the free memory pool for executive 
internal allocations. If specified as an odd value, this parameter is rounded 
up to the next even value. 

STANDARD J3TACK_SIZE (SSS) 

Size, in bytes, of the task's stack size when the initiator of the task does 
not specify a stack size to the executive. If specified as an odd value, this 
parameter is rounded to the next even value. 

DEFAULT JCHANNEL JTRUNK (DCT) 

Specifies the default channel trunk to be used for the configuration of the 
NOS Network Products interface, gateways, and network management 
entities that use NOS services. If a default channel trunk is not specified 
and the DI was loaded across an MCI interface, the trunk over which the 
DI was loaded becomes the default channel trunk. If a default channel 
trunk is not specified and the DI was not loaded across an MCI interface, 
the default channel trunk for the DI is not defined. 

ROUTING _SYSTEM (RS) 

This parameter is used only in DIs that are supported by NOS hosts. For 
this release of CDCNET, the feature that uses this parameter is not 
supported, and the value of this parameter is always FALSE. 
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CLOCKING J3YSTEM (CS) 

Indicates that this DI is to contain the master clock that specifies the date 
and time for the network. All other DI clocks set their date and time 
according to this master clock. For DIs connected to a NOS host, there 
must be only one clocking system DI defined in the catenet with 
CLOCKING_SYSTEM=TRUE. For DIs supported by NOS/VE hosts, this 
parameter is not needed, since the DIs obtain the master clock from the 
NOS/VE host rather than from a clocking system DI. The value of this 
parameter for an MDI/MTI connected to a NOS/VE host should be FALSE. 
This parameter is illegal for an ICA-II system. 

MAXIMUM _RECOVERIES (MR) 

Specifies the maximum number of task recoveries allowed in a 60-minute 
period before the DI is reset. 

COMPRESS _DUMP (CD) 

Requests a compressed dump (omits free memory and buffers) of DI 
memory. Possible parameter values are YES and NO. 

Responses Change of system accepted. 

—WARNING- Change of system accepted. System was not the master clock. 

-WARNING- Change of system accepted. System was already the master 
clock. 

-WARNING- Change of system accepted. Power on reset <P1> used, 
please correct. 

-ERROR— Clocking _system can not be specified for an ICA II system. 

—ERROR— Buffer _boundary_percentages values not decreasing or do not 
differ by 5. The buffer boundary percentages are = (<P1>,<P2>,<P3>). 

-ERROR— Memory ..boundary _percentages values not decreasing or do not 
differ by 5. The memory boundary percentages are = 
(<P1>,<P2>,<P3». 

-ERROR- System is not yet defined. 

-ERROR- There is already a master clock in catenet. Network Id: xxxxxx, 
System Id: xxxxxxxxxxxx. 

—FATAL— The system could not be started as master clock. 

Remarks Proceed with caution if you use values other than the default values for 
any of the memory management parameters (DATA_BUFFER_SIZE 
through STANDARD_STACK_SIZE). Changing these values may improve 
system performance, but can significantly degrade performance as well. 

Examples change.system mbp-(70,80,90) 
Change of system accepted. 
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CHANGE JTCP_INTERFACE (CHATI) 
NETOU Command 

Purpose Changes the operational parameters for TCP (DOD's Transmission Control 

Protocol). Changed values that are negotiated at the beginning of a 
connection only affect new connections. All other changes occur 
immediately for all connections. Only parameters that are specified by this 
command are changed. 

Format CHANGE _TCP_INTERFACE 

ACCEPT .STRATEGY = keyword value 

ACK PERCENTAGE = 0..100 

MAX_BUFFERS = 1..65535 

MAX SEGMENT .SIZE = 1..4096 

MAX .CONNECTIONS = 0..512 or INFINITE 

QUIETJTIME = 0..10000 

RETRANSMIT .STRATEGY = keyword value 

RETRANSMIT JTIME = 0..65535 

SECURITY .CHECKING = keyword value 

TIMEJTOj^rVE = 0.255 

SYN^ACK.TIME = 2..10000 

Parameters ACCEPT J5TRATEGY (AS) 

Specifies the TCP segment accept strategy to be used. The following 
keyword values are allowed: 



Keyword Value 



Description 



IN_ORDER (10) 



IN_WINDOW (IW) 



Segments are accepted only in the exact order 
they are expected. All other segments are 
discarded. Using this parameter may cause 
performance degradation and increase the 
number of retransmitted segments. 

Segments are accepted if they fall within the 
current TCP window. All other segments are 
discarded. 



ACK PERCENTAGE (AP) 

Specifies the percentage of the receive window that must be full before an 
acknowledgment is issued. 

MAXJBUFFERS (MB) 

Specifies the maximum number of data bytes that TCP holds for a 
connection for both directions of travel. 

MAX .SEGMENT .SIZE (MSS) 

Specifies the maximum segment size in bytes to be negotiated for each new 
connection. 

MAX .CONNECTIONS (MC) 

Specifies the maximum number of simultaneous TCP connections. If 
INFINITE is entered, no restriction is placed on the number of connections. 
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QUIETJTIME (QT) 

Specifies the number of seconds that TCP must wait, after a connection 
has closed, before a connection with the same source and destination socket 
addresses can be opened again. 

RETRANSMIT _STRATEGY (RS) 

Specifies the TCP segment retransmission strategy to be used. The 
following keyword values are allowed: 



Keyword Value 



Description 



BATCH (B) 



FIRST_ONLY (FO) 



ADAPTIVE (A) 



All unacknowledged segments are 
retransmitted when the retransmission timer 
expires. 

Only the first segment of a sequence of 
unacknowledged segments is retransmitted 
when the retransmission timer expires. 

Each connection starts in FIRST_ONLY mode. 
If a subsequent retransmission sequence 
causes TCP to perform batch retransmission 
as a series of retransmissions, then TCP 
switches to BATCH mode. This case detects 
the instance where the peer TCP is using an 
IN_ORDER accept strategy. 



RETRANSMIT JTIME (RT) 

Specifies the initial number of seconds that TCP should wait for an 
acknowledgment before retransmitting a data segment. This value changes 
for an active connection as the actual round-trip time is learned. 

SECURITY JCHECKING (SC) 

Specifies the security checking to be performed on all segments. The 
following keyword values are allowed: 



Keyword Value 



Description 



NONE (N) 



USER .SPECIFIED (US) 



LEVEL _U (LU) 



The security option supplied in IP datagrams is 
ignored. 

The security option specified by the upper layer 
protocol in the passive or active connect 
request establishes the security level of the 
connection. 

All connections must be at security level 
UNCLASSIFIED. 
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Keyword Value 



Description 



Examples 



LEVEL _C (LC) 
LEVEL_E (LE) 
LEVEL_M (LM) 
LEVEL_P (LP) 
LEVEL_R (LR) 
LEVEL_S (LS) 
LEVEL_T (LT) 



All connections must be at security level 
CONFIDENTIAL. 

All connections must be at security level 
EFTO. 

All connections must be at security level 

MMMM. 

All connections must be at security level 
PROG. 

All connections must be at security level 
RESTRICTED. 

All connections must be at security level 
SECRET. 

All connections must be at security level TOP 
SECRET. 



If a security level is specified, all connections and all segments received on 
a connection must match that security level. Any data segments that do 
not match the security level for a connection are discarded. 

TIME_TO_LWE (TTL) 

Specifies the Internet Protocol (IP) time-to-live field used by TCP. This is a 
hop count that is decremented at each gateway traversed by a datagram. 
When the count in a datagram reaches zero, the datagram is discarded to 
prevent looping. 

SYN_ACK_TIME (SAT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of the initial SYN segment. The connection is aborted at 
timeout. A SAT time too small can cause connection disconnects before the 
remote host has time to respond. A large SAT time can cause users to 
wait long periods of time for an unavailable host. Default is 60 seconds. 



Responses TCP options changed. 



-WARNING— Maximum number of connections cannot be changed. The 
maximum number of connections must be greater than or equal to the 
number of active connections. If other parameters have been specified, they 
have been changed. 

-ERROR- TCP is not defined. 

change_tcp_1nterface accept_strategy=1n_w1ndow .. 
ack_percentage=75 max_buffers=512 max_connect1ons=INFINITE 

TCP options changed. 
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CHANGE _TEL.NET .SERVER (CHATS) 
NETOU Command 

Purpose Changes the operational parameters of a particular Telnet server. The 

original values were previously specified by the ADD_TELNET_SERVER 
command. 

NOTE 



Changes to the TDP, TUP, PFO, ION, and VU parameters take effect with 
new connections to the gateway but do not affect existing connections. All 
other changes take effect for existing connections as well. 

Format CHANGE .TELNET SERVER 

SERVER JNAME = name 

TERMINAL DEFINITION JPROCEDURE = name or NONE 
TERMINAL _USER _PROCEDURE = name or NONE 
PROCEDURE _FILE JOPTION - IP ^ADDRESS JCONCATENATION 
or none 

CONNECTION JCONNECTJTIMEOUT = 20..1000 or INFINITE 
CONNECTION DISCONNECT JTIMEOUT = 0..1000 or INFINITE 
USER CONNECTION JJMIT = 1..16 

INITIAL JOPTION .NEGOTIATION = list 0..3 of keyword or NONE 
VALIDATE JUSERS = boolean 
TCPJTIMEOUT = 0..65535 or INFINITE 

Parameters SERVER _NAME (SN) 

Specifies the name of the Telnet server to be changed. 

TERMINAL DEFINITION PROCEDURE (TDP) 

Specifies the TDP automatically executed for all users when they first 
access this Telnet server. NONE specifies that no TDP is to be 
automatically executed. 

TERMINAL _USER PROCEDURE (TUP) 

Specifies the TUP automatically executed for all users when they first 
access this Telnet server. NONE specifies that no TUP is to be 
automatically executed. This parameter can only be used when the TDP 
parameter has a value of NONE. 

PROCEDURE _FILE JOPTION (PFO) 

Specifies one of two options for qualifying the procedure name specified by 
either the TDP or TUP parameter. Specifying IP_ADDRESS_ 
CONCATENATION causes the remote IP address identified within the 
incoming connection to be concatenated with the name specified by either 
the TDP or TUP in effect for this server. If neither a TDP nor TUP is in 
effect for this server, this parameter is ignored. NONE selects no 
concatenation. 

CONNECTION JCONNECTJTIMEOUT (CCT) 

Defines how much time the Telnet user has to create the first 
$input/$output connection. If no connection is established within that time, 
the Telnet connection is terminated. INFINITE indicates an infinite time. 
The timer has a precision of +/-2 seconds. 
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CONNECTION _DISCONNECT JTIMEOUT (CDT) 

Defines how much time the Telnet user has to establish a new 
$input/$output connection after the last such connection has been 
disconnected. If no new connection is established within that time, the 
user's connection is terminated. INFINITE indicates an infinite time. 

USER JCONNECTION JJMIT (UCL) 

Defines the maximum number of interactive $input/$output connections 
allowed at any one time by a Telnet user. 

INITIAL JDPTION .NEGOTIATION (ION) 

Specifies the set of Telnet options to be negotiated (transmitted) by this 
Telnet server during the initial startup of all Telnet connections. Any 
subset of the keywords; WILL_SGA, WILL_ECHO, and DO_SGA may be 
specified or the single keyword NONE may be specified. A list containing 
the keyword NONE is treated as if NONE were the only keyword 
specified. The keyword NONE specifies that no Telnet option negotiation is 
to be initiated by this Telnet server. 

VALIDATE JUSERS (VU) 

Specifies if the Telnet users accessing this Telnet server are validated 
when user validation is enabled by the DEFINE _USER .VALIDATION 
command. If VU is TRUE, users are validated when validation is enabled. 

TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of data transmission. If an acknowledgment is not received 
within the specified period, TCP aborts the connection. Entering a small 
value (less than a few seconds) may cause frequent and unnecessary loss of 
service during periods of network congestion. Entering a large value may 
cause users to wait a long time after the host or network has failed. If you 
enter INFINITE, the connection will not time out. The default value is 300 
seconds. 

Responses TELNET server < server _name> is changed. 

-WARNING- TELNET server < server _name> was not found. 

Examples change_telnet_server server.name = arhnet.. 

user_connect1on_ limit = 5 valldate.users = TRUE 

TELNET server ARHNET Is changed. 
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CHANGE .TELNET .SERVICE .NAME (CHATSN) 

Purpose Changes the name of the Telnet service used when accessing Telnet from 
this DI. This service is accessed when a NOS/VE host application has 
issued a VTP Create CDCNET Connect request to a Telnet service. This is 
done, for example, when a terminal user executes the CREATE _TELNET_ 
CONNECTION (TELNET) command on a NOS/VE system. 

Format CHANGE .TELNET SERVICE NAME 

SERVICE _NAME = name 

Parameters SERVICE _NAME (SN) 

Specifies the name of the Telnet service to be used when accessing Telnet 
from this DI for the situations described above. The name must be the title 
of a User Telnet Gateway configured in the network. The default prior to 
an explicit CHANGE _TELNET_SERVICE_NAME is TELNET. 

Responses Telnet service name is changed to < service _name>. 

-ERROR- Telnet service name < service _name> is already defined. 
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CHANGE _USER TELNET GW (CHAUTG) 
NETOU Command 

Purpose Changes operational parameters of a user TELNET gateway. The original 
values for these parameters were defined by the DEFINE _USER_ 
TELNET_GW command. Any changes specified by this command affect 
only new connections to the gateway; existing connections are not affected. 

Format CHANGE _USER .TELNET GW 

GATEWAY_NAME = name 

IP^ADDRESS = list 4 of 0..255 
TITLE = list 1..15 of name 
TRANSLATION _J>OMAIN = CATENET 
MAX JCONNECTIONS = 0..65535 or INFINITE 
SOURCE _JP_ADDRESS = list 4 of 0.255 
TCP_PORT_NUMBER = 0..65535 
TCP_ALLOCATE JSIZE = 0.2147483647 
TCPJTIMEOUT = 0..65535 or INFINITE 
INACTIVITY JTIMEOUT = 0..65535 

Parameters GATEWAY_NAME (GN) 

The logical name of the user TELNET gateway used in subsequent 
commands that reference the gateway. 

IP_M>DRESS (IA) 

The IP address of the host which provides the TELNET interactive service. 
This user TELNET gateway establishes a connection using this IP address 
as the destination address. The format is similar to the decimal octet 
convention used by the TCP/IP community, except that the periods are 
replaced with commas, and the list is enclosed in parentheses. For 
example, the IP address 128.2.53.7 is represented as (128,2,53,7). 

TITLE or TITLES (T) 

Specifies the title(s) by which this gateway service can be accessed. For 
example, this is the name that CDCNET terminal users supply in the 
CREATE ^CONNECTION command. 

TRANSLATION jyOMAIN (TD) 

Specifies the portion of the CDCNET catenet that can access this service. 

MAX JCONNECTIONS (MC) 

Specifies the maximum number of simultaneous connections to be supported 
by the gateway. If INFINITE is entered, there is no restriction to the 
number of connections allowed. 

SOURCE _JP_ADDRESS (SIA) 

Specifies the IP address of the source host to be used by this gateway. The 
format is similar to the decimal octet convention used by the TCP/IP 
community, except the periods are replaced with commas and the list is 
enclosed in parentheses. For example, the IP address 128.2.53.7 is 
represented as (128,2,53,7). 
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TCP _PORT ^NUMBER (TPN) 

Specifies the TCP port number to be used by the gateway. User TELNET 
issues a TCP active _connect request using the well-known port for the 
destination port. 

TCP_ALLOCATE_SIZE (TAS) 

Specifies the amount of data that the gateway queues for each connection. 
Larger values may improve user response time, especially for PC users 
(with a standard protocol such as XMODEM), but can increase the number 
of instances of DI congestion. 

CAUTION 

Specifying this value is discouraged, and should be done with caution, as 
poor network service results. 



TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of data transmission. If an acknowledgment is not received 
within the specified period, TCP aborts the connection. A small value (less 
than a few seconds) might cause frequent and unnecessary loss of service 
during periods of network congestion. A large value might leave users 
waiting a long period of time after a host or network has failed. If 
INFINITE is entered, the connection never aborts. 

INACTIVITY JTIMEOUT (IT) 

Specifies the interval (in seconds) between inactivity checks. If a connection 
has been idle for the specified time, the gateway sends a TELNET status 
request to the remote TELNET to determine if the connection is still 
usable. 

Responses User TELNET gateway < gateway _name> is changed. 

-ERROR- User TELNET gateway < gateway _name> is not defined. 

Examples change_user_telnet_gw gateway_name=gw_to_vax . . 

t1tle=(te1net_vax, telnet.unix) max_connect1ons=10 

User TELNET gateway GW_TO_VAX Is changed. 
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This chapter provides complete descriptions of all CDCNET DEFINE commands used 
for network configuration and operations activities. Command descriptions are organized 
alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 



60000414 D DEFINE Commands 6-1 



DEPINE_BO0TJDEFAULTS (DEFBD) 



DEFINE _BOOTJDEFAULTS (DEFBD) 
Exception List Command 

Purpose Sets the default software version and dump criteria for DIs without a 

specific exception list entry. This command must be the first command in 
the exception list and cannot be omitted. This command also specifies 
default values for DEFINE _EXCEPTION_SYSTEM command parameters 
having the same name. 

Ths command is valid only in an exception list. Do not use this command 
in a DI configuration procedure. 

Format DEFINE _BOOT_DEFAULTS 

DEFAULT_VERSION = O..OFFFF(16) 

DELETE _DUMP_ON _ERROR = list 1..10 of O..OFF(16) 

Parameters DEFAULT.VERSION (DV) 

Version number of the CDCNET object library and boot file to load into 
DIs. This value consists of one through four hexadecimal digits. Any 
version number that starts with an alphabetic character must have a 
leading zero when it is entered in the exception list. The SET_ VERSION. 
LEVEL installation procedure requires the abbreviated form (DV) of this 
parameter (see Remarks). 

DELETE J)UMP JON JERROR (DDOE) 

List of error conditions (besides power-on reset) that do not cause a DI to 
dump its memory before loading. Specify the error conditions as one- or 
two-digit hexadecimal numbers. Default is to dump the DI before loading 
for all conditions but power- on reset (reset code 00(16)) and the KILL_ 
SYSTEM command with the DUMP parameter set to NO (reset code 
33(16)). 

Remarks Two CDCNET software items are assigned a version number: 

• CDCNET software release. This version number is embedded in the 
CDCNET software and cannot be changed by a network administrator. 

• CDCNET object library and boot file. This version number is used for 
the DEFAULT_VERSION parameter value on this command. It specifies 
the boot and object library to load into a DI. 

To allow the SET_VERSION_LEVEL installation procedure to alter the 
default version level (see NOS Installation handbook and CDCNET 
Installation section of the NOS/VE Software Release Bulletin), use the 
abbreviated form of the DEFAULT_VERSION parameter (DV=t?uuu(16) 
where vvvv is the software version level). Also, the NOS permanent file 
name of the exception list must be ELIST. The SETVL procedure does not 
alter entries in the DEFINE .EXCEPTION _SYSTEM command. 

On NOS, this command has no effect for host- connected DIs (MDIs and 
MTIs). For host-connected DIs, you must use the INITDCN file described 
in the NOS Installation handbook. 



Examples This example establishes version 0403 as the default software version to 
load. 

def1ne_boot_defaults dv=0403(16) 
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DEFINE .CHANNEL .TRUNK (DEFCT) 

DI Configuration Procedure/NETOU Command. 

Purpose Defines the channel level interface to a NOS host. 
NOTE 



Format 



Parameters 



Do not use this command for an ICA-II or from a DI to a NOS/VE host. 
Instead, use DEFINE _VE_INTERFACE, described later in this chapter. 



DEFINE .CHANNEL JTRUNK 
SLOT = 0..7 
TRUNK J^AME = name 
UPLINE ^MESSAGE JTIMEOUT = 2..64 
CHANNEL JTIMEOUT = boolean 

SLOT (S) 

Board slot number of the MCI board. 

If a DI has only one MCI, this parameter is optional. If a DI has more 
than one MCI, this parameter is required. 

TRUNK J^AME (TN) 

Logical name of the channel trunk. The default name is constructed using 
the SLOT parameter, as in $MCI7. 

UPLINE .MESSAGE JTIMEOUT (UMT) 

This parameter is no longer in use. If a value is specified, it is ignored. 

CHANNEL JTIMEOUT (CT) 

How MCI software handles host peripheral processor (PP) interruptions. 
This parameter is intended for use by customers during joint software 
development with Control Data. The following values are allowed: 



Value 



Description 



TRUE 



FALSE 



MCI software detects when a host PP stops 
operating, downs the channel interface, and 
attempts recovery. 

MCI software does not detect when a host PP 
stops operating. Specify FALSE only when 
debugging host PP software. 



Default is TRUE. 
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DEFINE _CHANNEL_TRUNK (DEPOT) 

Responses CHANNEL trunk < trunk _name> defined. 

-ERROR- Trunk name < trunk _name> already defined. 

-ERROR- Board slot xx does not contain a CHANNEL board. 

-ERROR- The Device Interface does not contain a CHANNEL board. 

-ERROR- The Device Interface contains more than one CHANNEL board 
— the slot must be specified. 

-ERROR- Specified CHANNEL board is not on. 

-ERROR- Specified CHANNEL board is already in use. 

-ERROR- TRUNK <name> is the boot source. 
< Parameter > cannot be redefined. 

—ERROR- Define _channel_trunk can not be executed in an ICA II 
system. 

—FATAL- Not enough memory is currently available for required table 
space. 

Remarks If this command is performed for the channel trunk over which the DI was 
loaded, it redefines the trunk with the specified options. To redefine the 
channel trunk over which the DI was loaded, this command must be in the 
configuration file. During reconfiguration, you can provide a new TRUNK _ 
NAME. However, we recommend not changing the CHANNEL JTIMEOUT 
parameter. 

MCIs in an MDI should always be placed in the highest slot position(s) in 
the MDI/MTI to ensure MPB provides correct priority of service. 

Examples def 1ne_channel_trunk slot=7,trunk_name=channel_trunk_2 

CHANNEL trunk channel _trunk_2 defined. 
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DEFINE .DEVICE _OUTCALL .SERVICE (DEFDOS) (NOS/VE 

Only) 

DI Configuration Procedure/NETOU Command 



Purpose 



Installs the Device Outcall service in a DI. Use this command in the 
configuration files of all DIs with devices that can receive connections from 
host applications. 

NOTE 

In future releases, this command will no longer be supported. You should 
start using the DEFINE .OUTCALL _GATEWAY_STATUS command as 
soon as possible. 



Format 



DEFINE .DEVICE .OUTCALL .SERVICE 

TITLE = name 



Parameters TITLE (T) 

Title of the device outcall service. Devices connect to the device outcall 
service using CREATE .CONNECTION, with the SERVICE _NAME 
parameter equal to this parameter value. Default is DEVICE _OUTCALL. 

Responses Device Outcall Service < title > defined and started. 

-ERROR- Device Outcall Service previously defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks Desktop/VE uses the CDCNET Device Outcall service. DEFINE .DEVICE _ 
OUTCALL .SERVICE is only available for use with Desktop/VE. The 
default TITLE parameter value (DEVICE _OUTC ALL) must be used. 

Examples def 1ne_device_outcall_serv1ce tit1e=device_out 

Device Outcall Service device_out defined and started. 
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DEFINE _EGP_PEER (DEFEP) 

DI Configuration Procedure/NETOU Command 

Purpose Configures parameters for a peer Exterior Gateway Protocol (EGP) 

gateway, in which CDCNET exchanges IP network routing information 
using the EGP. Normally, EGP reports all known IP networks (residing in 
the network routing tables) to all its peers. In some cases, a site might 
want to isolate an IP network from DDN access. This is done using ADD_ 
EGP_REPORTED_NETS. 

NOTE 

Defaults for the protocol intervals, timeouts, thresholds, and adjust 
parameters are recommended by the protocol definition (see RFC 904). Use 
the defaults unless you have communications problems with a particular 
EGP peer. Before adjusting parameters, analyze the communications 
problems, network topology, and the EGP. 

Format DEFINE _EGP_PEER 

IP.ADDRESS = list 4 of 0..255 
AUTONOMOUS .SYSTEM .NUMBER = 1..65535 

PEER JRECOVERY = keyword value 
MINIMUM _ffELLO INTERVAL = 1..9999 
MINIMUM _POLL JNTERVAL = 1..9999 
REQUEST _CEASE INTERVAL = 1..9999 
HOLD.UP.DOWN .TIMEOUT = 1..9999 
HOLD ACQUISITION .CEASE JTIMEOUT = 1..9999 
ACTIVE ..NEIGHBOR .UP .THRESHOLD = 1..9 
ACTIVE .NEIGHBOR _DOWN .THRESHOLD = 1..9 
PASSIVE .NEIGHBOR .UP .THRESHOLD = 1..9 
PASSIVE .NEIGHBOR .DOWN .THRESHOLD = 0..9 
TRANSMIT JIELLO ^ADJUST = 1..9999 
TRANSMIT _J>OLL ^ADJUST = 1..9999 
RECEIVED .HELLO ^ADJUST = 1..9999 
RECEIVED ^POLL .ADJUST = 1..9999 
TESTJPJJETWORK = boolean 
START = boolean 

Parameters IP_ADDRESS (IA) 

IP address of the EGP peer with which the neighbor acquisition protocol is 
exchanged. This IP host address must be on a directly connected wide area 
network (WAN) defined by DEFINE _IP_NET. The format is similar to the 
decimal octet convention used by TCP/IP, except the periods are replaced 
with commas, and the list is enclosed in parentheses. For example, the IP 
address 128.2.53.7 is represented as (128,2,53,7). 

AUTONOMOUS .SYSTEM .NUMBER (ASN) 

Autonomous system number of this local network, identifying IP networks 
this EGP gateway supports. This number is assigned by Stanford Research 
Institute (SRI). 
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PEER RECOVERY (PR) 

Peer recovery. Values include AUTO, MANUAL, and BACKUP. For a 
single peer, specify AUTO for backup support or MANUAL for no backup 
support. 



Keyword Value Description 



AUTO (A) When the start command (START_EGP_PEER) is 

received for the peer, EGP attempts to acquire the 
peer. If EGP cannot acquire the peer or loses the 
peer later, it attempts a BACKUP peer 
acquisition. 

MANUAL (M) When the start command (START_EGP_PEER) is 

received for the peer, EGP attempts to acquire the 
peer. If EGP cannot acquire the peer or loses the 
peer, it does not attempt a BACKUP peer 
acquisition. 

BACKUP (B) When the start command (START_EGP_PEER) is 

received for the peer, the peer is eligible to be 
acquired if the AUTO peer cannot be acquired or 
acquisition is lost. When the total active AUTO or 
MANUAL peers for a network falls below the 
total started AUTO peers, a BACKUP peer for 
that network initiates to fill the vacancy. 

Default is AUTO. 

MINIMUM NIELLO INTERVAL (MHI) 

Minimum interval, in seconds, acceptable between successive HELLO 
commands. This parameter is the EGP variable PI, the value reported to 
the EGP peer as the desired minimum interval between HELLO commands 
received from that peer. Default is 30 seconds. 

MINIMUM _J>OLL INTERVAL (MPI) 

Minimum interval, in seconds, acceptable between successive POLL 
commands. This parameter is the EGP variable P2, the value reported to 
the EGP peer as the desired minimum interval between POLL commands 
received from that peer. Default is 120 seconds. 

REQUEST _CEASE INTERVAL (RCI) 

Interval, in seconds, maintained between REQUESTS or CEASE command 
retransmissions. This is the EGP variable P3. Default is 30 seconds. 

HOLDJJPJXMN JTIMEOUT (HUDT) 

Interval, in seconds, during which state variables are maintained in the 
absence of responses in the up and down states. This is the EGP variable 
P4. The interval is normally set to hold information while the peer dumps 
and restarts. Default is 3600 seconds. 
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HOLD .ACQUISITION JOE ASE JTIMEOUT (HACT) 

Interval, in seconds, during which state variables are maintained in the 
absence of responses in the acquisition and cease states. This is the EGP 
variable P5. Default is 120 seconds. 

ACTIVE NEIGHBOR JUPJTHRESHOLD (ANUT) 

Neighbor-up threshold used in the active mode of the neighbor reachability 
algorithm. Default is 3. 

ACTIVE NEIGHBOR _J>OWN ^THRESHOLD (ANDT) 

Neighbor- down threshold used in the active mode of the neighbor 
reachability algorithm. Default is 1. 

PASSIVE NEIGHBOR _UP JTHRESHOLD (PNUT) 

Neighbor-up threshold used in the passive mode of the neighbor 
reachability algorithm. Default is 1. 

PASSIVE .NEIGHBOR _DOWN JTHRESHOLD (PNDT) 

Neighbor- down threshold used in the passive mode of the neighbor 
reachability algorithm. Default is 0. 

TRANSMIT JHELLO_ADJUST (THA) 

Increases the interval, in seconds, between successive hello messages 
transmitted. Lengthening the hello interval can prevent violating the 
minimum hello interval because of bunching in the net. Default is 10. 

TRANSMIT JPOLL_AD JUST (TPA) 

Increases the interval, in seconds, between successive poll messages 
transmitted. Lengthening the poll interval can prevent violating the 
minimum poll interval because of bunching in the net. Default is 20. 

RECEIVED JKELLO ^ADJUST (RHA) 

Specified in seconds, this value is subtracted from the incoming hello 
interval in request or confirm messages. The result is the minimum 
acceptable interval between received hello messages. Default is 5 seconds. 

RECEIVED JPOLL ^ADJUST (RPA) 

Specified in seconds, this value is subtracted from the incoming poll 
interval in request or confirm messages. The result is the minimum 
acceptable interval between received poll messages. Default is 15 seconds. 

TEST _JP NETWORK (TIN) 

Used only for testing. Normally, EGP peers must connect to the same IP 
network. This parameter configures a peer on a remote network. That is, it 
allows the peer to reside on an IP network not directly connected to the 
local EGP. Values include TRUE and FALSE. If the parameter is TRUE, 
the IP_ADDRESS parameter can be any IP network address and is not 
checked for an address directly connected to the local EGP. Default is 
FALSE. 
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START (S) 

Whether or not the EGP gateway starts after configuration. Values are 
TRUE and FALSE. If START is TRUE and PEER_RECOVERY is either 
AUTO or MANUAL, EGP attempts peer acquisition immediately. If START 
is TRUE and PEER .RECOVERY is BACKUP, peer acquisition may be 
started if one of the other peer acquisitions fails. If START is FALSE, no 
action is taken for this peer definition until START_EGP_PEER is 
received. Default is TRUE. 

Responses EGP Gateway Peer <ip_address> is defined and started. 

EGP Gateway Peer <ip_address> is defined. 

-ERROR— EGP Gateway Peer <ip_address> is already defined. 

—ERROR— EGP Gateway Peer <ip_address> is not on a directly 
connected IP Network. 

—FATAL— Not enough memory is currently available for required table 
space. 

Examples def 1ne_egp_peer i p_address= ( 10,61,0,2) .. 
aut onomous_syst em_number =78 

EGP Gateway Peer 10,61,0,2 is defined and started. 
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DEFINE _ETHER _NET (DEFEN) 

DI Configuration Procedure/NETOU Command 

Purpose Configures a CDCNET Ethernet network solution using a previously 
defined Ethernet trunk. An "unable to start" error leaves the network 
defined but not started. 

Format DEFINE _ETHER _NET 

TRUNK _NAME = name 
NETWORK _ID = 1..0FFFFU6) 

NETWORK JiAME = name 

COST = 0..7FFFFFFF(16) 

RELAY ^ALLOWED = boolean 

MULTICAST NETWORK = boolean 

ROUTING _INFO NETWORK = boolean 

START = boolean 

ARCHITECTURE JTYPE = list 1..2 of keyword value 

OUTPUT JQUEUE _LIMIT = 10000. .500000 

INCOMING JSERVICE _ACCESS = list 1..11 of keyword value 

OUTGOING .SERVICE ^ACCESS = list 1.11 of keyword value 

Parameters TRUNK _NAME (TN) 

Logical name of the Ethernet trunk used for the network solution. The 
Ethernet trunk with this name must be configured by DEFINE _ETHER_ 
TRUNK before this command executes. 

NETWORK _ID (NI) 

CDCNET network identifier of the Ethernet network solution. This number 
must be unique within the catenet. 

NETWORK _NAME (NN) 

Logical name of the network solution; used in subsequent commands 
referring to the network solution. The default name is constructed from the 
NETWORK _ID parameter, using the format $NET_xca;x:c, where xxxxx is 
the network ID expressed in decimal. For example, a network ID of 200 
results in a default name of $NET_200. 

COST (C) 

Relative cost of the network solution as a path for routing data through 
the network. The default cost of an Ethernet trunk is 0A(16), the cost of a 
10 M byte trunk. If the cost specified is greater than 0FFFF(16), 
0FFFF(16) is used for the COST parameter value for compatibility reasons. 

CDCNET routing uses cost to determine the least- cost routes for 
interconnecting networks. If multiple paths are available, the least- cost 
path is used. As a network becomes congested, its cost increases. It is 
extremely rare for an Ethernet network solution to become congested. 
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RELAY .ALLOWED (RA) 

Whether or not relay is allowed through this network solution. Values are 
TRUE, relay allowed; and FALSE, relay not allowed. Default is TRUE. 

If RA is TRUE, the DI relays traffic between this network and other 
connected networks regardless of the definition of the other networks. If 
RA is FALSE, the DI still relays traffic between this network and any 
connected networks defined with RA=TRUE. If RA is FALSE, the DI does 
not relay traffic between this network and other connected networks 
defined with RA= FALSE unless no other nonrestricted route exists between 
the networks. 

The following example illustrates these rules. 



Network A 
RA=FALSE 




Network B 
RA=TRUE 



Network C 
RA=FALSE 



Relay Between: 



Allowed/Not Allowed: 



Network A and Network B 
Network A and Network C 

Network B and Network C 



Allowed (RA is TRUE for Network B). 

Not allowed (RA is FALSE for both 
Network A and Network C). 

Allowed (RA is TRUE for Network B). 



MULTICAST ^NETWORK (MN) 

Whether or not the network solution is a multicast network. A multicast 
network supports sending a message to more than one device at a time. 
Values are TRUE and FALSE. Default is TRUE. 

ROUTING JNFO JVETWORK (RIN) 

Whether or not the network solution carries CDCNET routing information. 
Routing information pertains both to the proprietary CDCNET IS-IS 
routing protocol, as well as the ES-IS routing protocol. If RIN is TRUE, 
routing information describing all networks to which this system connects 
is sent over the network solution. If RIN is FALSE, routing information is 
not sent by this system over the network solution. This system appears 
unconnected to any network other than this network solution. Default is 
TRUE. 

START (S) 

Whether or not the network solution starts after configuration. Values are 
TRUE, start; and- FALSE, do not start. Default is TRUE. 

ARCHITECTURE JTYPE (AT) 

This parameter is no longer supported. Specification is valid but the value 
is ignored. 
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OUTPUT JQUEUE JUMIT (OQL) 

Maximum data, in bytes, retained in the output queue for the network 
solution if the DI's operating system buffer queue state is poor or worse. If 
messages must be discarded, newer output messages are discarded first. 

Default depends on network cost (see COST parameter). If the cost is 
6FA(16) or more, default is 30000 bytes. Otherwise, default is 60000 bytes. 

INCOMING ^SERVICE ^ACCESS (ISA) 

Specifies which services may be accessed coming in via the network 
solution. The keyword values are: 



Keyword Value 



Description 



ALL 

NONE 

application 

batch _support 
interactive 



nos_interactive 



passthrough 



All services are allowed. 

No services are allowed. 

Any service not identifiable by keyword 
batch _support, interactive, file ..transfer, 
or network _management. 

Any batch input and output services are 
allowed. This includes batch control 
facility, batch job submittal, and batch 
output. 

All interactive services are allowed. 
Interactive service supports terminal user 
access. Specifying this keyword is the 
same as specifying all of the following 
interactive service keywords: nos_ 
interactive, passthrough, t_passthrough, 
user_telnet, x25 ..terminal _gw, and ve_ 
interactive. 

All interactive services provided by NOS 
mainframes are allowed. 

All site- defined passthrough services are 
allowed. A site- defined passthrough service 
is provided when a passthrough title is 
created during the execution of a 
Terminal User Procedure (TUP) when a 
line is activated. This service allows 
asynchronous interactive devices to make 
connections to passthrough titles of this 
type through asynchronous ports and 
exchange information using CDCNET's 
transparent data feature. 
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Keyword Value 



t_passthrough 



user_telnet 



x25 _terminal _gw 



ve_interactive 
file_transfer 

network _management 
Default is ALL. 



Description 



All user-defined passthrough services are 
allowed. A user-defined passthrough 
service is provided when an interactive 
terminal user creates a connection to the 
interactive passthrough server, and defines 
a passthrough title either by entering the 
required commands manually or by 
executing a Terminal User Procedure 
(TUP) via the DO command on the 
$CDCNET_COMMAND connection. This 
service allows asynchronous interactive 
devices to make connections to 
passthrough services of this type through 
asynchronous ports and exchange 
information using CDCNET's transparent 
data feature. 

All TELNET services are allowed. User 
TELNET is an interactive service which 
provides CDCNET terminal users with 
access to the interactive services of remote 
hosts on a TCP/IP network. 

All X.25 terminal services are allowed. 
The X.25 terminal gateway is an 
interactive service which provides 
CDCNET asynchronous terminal users 
.with access to the interactive services of 
remote hosts on an X.25 network. 

All interactive services provided by 
NOS/VE mainframes are allowed. 

All QTF/PTF file transfer services are 
allowed. File transfer services support 
user file (PTF) and queue file transfers 
(QTF). 

All network alarm, clock, command, file, 
and log services are allowed. 



OUTGOING _SERVICE ^ACCESS (OSA) 

Specifies which services may be accessed going out via the network 
solution. See the ISA parameter for the keyword values. 

Responses Ethernet network < network _name> defined for trunk < trunk _name>. 

Ethernet network < network _name> defined and started for trunk 
< trunk _name > . 

-WARNING- The 3A Command Processor has timed out 

waiting for response from SSR. 

Please check network status for completion of request. 
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-ERROR- Network < network __name> already defined for trunk < trunk _ 
name>. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- Trunk < trunk _name> is not an ETHERNET trunk. 

-ERROR- Network name < network _name> already defined. 

-ERROR- Network id < network _id> already defined. 

-ERROR- Trunk <trunk_name> is down. Unable to start network 

< network _name > . 

-ERROR- Trunk < trunk _jiame> is off. Unable to start network 

< network _name > . 

-ERROR- NETWORK <name> is the boot source. < Parameter > cannot 
be redefined. 

-ERROR-Network < network _name> already defined for 

trunk < trunk _name> by the boot source. 

Network id is < network _id>. 

The command network id is < network _id>. 

Please reenter the command with correct network id. 

-FATAL- Not enough memory is currently available for required table 
space. 

-FATAL- Unable to start task < entry _point_name>. 

-FATAL- Stream service error. The device manager did not accept a 
function for the ESCI board. 

-FATAL- Stream service error. Unable to initialize ESCI board. 
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Remarks 



Examples 



This command is required only in DIs configured with an Ethernet network 
solution. It is not required in DIs booted over the Ethernet trunk. If this 
command is for the Ethernet trunk over which the DI boot was received, it 
redefines the network with the specified options. To redefine the Ethernet 
network over which the DI is booted, this command must be in the 
configuration file. Currently, redefinable options are: 

NETWORK _NAME 

COST 

RELAY_ALLOWED 

MULTICAST.NETWORK 

ROUTING.INFO.NETWORK 

OUTPUT.QUEUE .LIMIT 

INCOMING .SERVICE. ACCESS 

OUTGOING .SERVICE .ACCESS. 

In this example, an NDI links two Ethernet network solutions (figure 6-1). 
Assume that service access between the two networks must be limited to 
the following: 

• QTF/PTF file transfers in either direction. 

• Interactive service in either direction. 

• Host.l provides network management and batch support for both 
networks. However, Host .2 provides those services only for ESCI. 

Net .2. 

Add the following to the configuration file for NDI.l: 

define_ether_net. . 

trunk_name=esc1_trunk_1 ,network_name=esci_net_l . . 
network_id=1.. 

outgoing_servlce_access=(batch_support ,f i le.transfer. Interactive. . 

network_management) . . 
1 ncoml ng.ser vi ce_access= ( f 11 e_t r ansf er , 1 nt er act 1 ve ) 

def1ne_ether_.net . . 

t r unk_name=esd _t runk_2 , net work_name=esci _net_2 . . 
network_1d=2 

Outgoing and incoming service access parameters are not included for 
esci_net_2 so service access defaults to ALL. 
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Figure 6-1. DEFEN Example 
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DEFINE _ETHER_TRUNK (DEFET) 

DI Configuration Procedure/NETOU Command 

Purpose Prepares an Ethernet cable to serve as a CDCNET trunk. Ethernet trunks 
used to load DIs are predefined by DI software. Executing this command 
for an already- defined trunk results in an error message. If a DI contains 
only one Ethernet trunk, you can omit this command from the DI's system 
configuration procedure, since the DI determines information required to 
define the trunk by the DI load process. 

Format DEFINE _ETHER JTRUNK 

SLOT = 0..7 
TRUNK_NAME = name 
MAX _FRAME _SIZE = 132..1514 
INTERFRAME _SPACING = 0.255 

Parameters SLOT (S) 

DI board slot number containing the Ethernet Serial Channel Interface 
(ESCI) board. If a DI has only one ESCI board, this parameter is optional. 
If a DI has more than one ESCI board, this parameter is required. 

NOTE 



Do not use this parameter for an ICA-II. 



TRUNK JtAME (TN) 

Logical name of the trunk. The default name is derived from the SLOT 
parameter, as in $ESCI3. For an ICA-II board, the default trunk name is 
$ICA_IEI. The trunk name must be unique in the DI. 

MAX _FRAME JSIZE (MFS) 

Maximum frame size, in bytes, the Ethernet can transmit over the 
Ethernet trunk. The value of this parameter must be coordinated with the 
DEFIN command if the DEFIP command configures an IP network over 
the trunk being configured. Default is 1514 bytes. 

INTERFRAME _SPACING (IS) 

Minimum time, in nanoseconds, between sending Ethernet frames after a 
transmission completes. Default is 96 nanoseconds. 
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Responses Ether trunk < trunk _name> defined. 

-ERROR- The Device Interface does not contain an ETHERNET board. 

-ERROR- Board slot <slot_number> does not contain an ETHERNET 
board. 

-ERROR- The Device Interface contains more than one ETHERNET 
board~the slot must be specified. 

-ERROR- Slot may not be specified for an ICA II system. 

-ERROR- Device state not on. Card slot = <slot_number>. 

-ERROR- Device already owned. Card slot = <slot_number>. 

-ERROR- Trunk name < trunk _name> already defined. 

-ERROR- Specified ETHERNET board is not on. 

-ERROR- Specified ETHERNET board is already in use. 

-ERROR- TRUNK <name> is the boot source. < Parameter > cannot be 
redefined. 

-FATAL- Not enough memory currently exists for required table space. 

Remarks • This command is required only in DIs configured with an Ethernet 

trunk. It is not required in DIs loaded over the Ethernet trunk. If this 
command is executed for the Ethernet trunk over which the DI boot 
was received, it redefines the trunk with the specified options. To 
redefine the Ethernet trunk over which the DI was booted, this 
command must be in the configuration file. Currently, the only options 
that may be redefined are TRUNK _NAME and MAX_FRAME_SIZE. 

• To ensure correct service priority by the MPB in a DI, the ESCI board 
should be installed in a slot position greater than any of the boards in 
the DI except the MCI. 

• A DI can support a maximum of three ESCI boards. 
Examples def 1ne_et her .trunk trunk_name=ETHER1,slot=4 
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DEFINE _EXCEPTION_SYSTEM (DEFES) 
Exception List Command 

Purpose Sets software version to load and load-time dump conditions for a specific 

DI. This software version and these dump -conditions differ from those 
specified for other DIs on the DEFINE _BOOT_DEFAULTS command. 

This command is valid only in an exception list. Do not use this command 
in a DI configuration procedure. 

Format DEFINE .EXCEPTION .SYSTEM 

SYSTEM .ID = O..OFFFFFF(16) 

VERSION DUMBER = O..OFFFF(16) 
SERVICE J5YSTEM = boolean 
DELETE JDUMP JON JSRROR = list O..OFF(16) 
ADD JDUMP JON JERROR = list O..OFF(16) 
TRANSMIT _R ATE = 4800. .2000000 

Parameters SYSTEM _ID (SI) 

Lower six hexadecimal digits of the DFs 12-digit system ID. The upper six 
hexadecimal digits of the system ID are always 080025 and are supplied by 
the DEFINE .EXCEPTION .SYSTEM command processor. 

VERSION _NUMBER (VN) 

Software version number consisting of one through four hexadecimal digits. 
Any version number that starts with an alphabetic character must have a 
leading zero when it is entered in the exception list. Default is the 
DEFAULT.VERSION parameter value on DEFINE .BOOT.DEFAULTS. 

SERVICE JSYSTEM (SS) 

Whether or not the DI should be loaded. Values include TRUE, load DI; 
and FALSE, do not load DI. Default is TRUE. 

NOTE 



The Initialization Management Entity (ME) in a NOS/VE host or a DI uses 
SERVICE _SYSTEM when deciding to initialize (dump and/or load) DIs. 
SERVICE .SYSTEM does not control where Initialization ME gets files, 
such as boot files, configuration procedures, and TDPs. Do not use this 
parameter to control which host provides CDCNET file support. Instead, 
use the DEFINE .FILE .SUPPORT command. 

DELETE JDUMP JON JERROR (DDOE) 

List of error conditions to add to the list specified on DEFINE .BOOT. 
DEFAULTS. Under these conditions, the DI does not dump before loading. 
These error conditions are listed in the table of DI reset codes in the 
CDCNET Configuration Guide. Default is the list of error conditions 
specified on DEFINE .BOOT.DEFAULTS. 
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Remarks 



ADD_J>UMP_ON_ERROR (ADOE) 

List of error conditions causing the DI to dump memory before loading. 
This list may add conditions deleted by the DELETE _DUMP_ON_ERROR 
parameter on this command and on DEFINE _BOOT_DEFAULTS. These 
error conditions are listed in the CDCNET Configuration Guide. Default is 
to add no error conditions to the currently defined list. 

TRANSMIT _RATE (TR) 

Transmit rate (bits per second) at which initialization attempts to transfer 
load and dump information. It is used to slow down the initialization so it 
does not exceed the bandwidth of a constriction hidden in the load media. 
The effective rate is the lower of the specified transmit rate and available 
media bandwidth. Default is 2 million bits per second. 

The SET_VERSION_LEVEL (SETVL) installation procedure (see NOS 
Installation handbook and CDCNET Installation section of the NOS/VE 
Software Release Bulletin) does not alter entries in the DEFINE _ 
EXCEPTION .SYSTEM command. You must alter them directly on this 
command. 



Examples The following command specifies that a DI with system ID 0800253000C2 
is loaded with software version 0402. The DI does not dump when error 
codes 21 and 22 occur. 

define_exception_system system_id=3000C2(16), .. 
version_number=0402(16),delete_dump_on_error=(21(16),22(16)) 
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DEFINE _FILE .SUPPORT (DEFFS) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the Independent File Access Management Entity (ME) in a DI and 
selects file types that can be accessed through the DI. 

This command is optional in the system configuration procedures of MDIs 
loaded over an MCI that provide file support for the network. The host 
must be configured to run the Network File Server application, NETFS. 

If this command is not in an MDI's configuration file, access to all 
CDCNET file types is supported. To have file support for a host whose 
MCI link was not used to load the MDI (that is, if multiple MCI boards 
are in the MDI or MTI), this command is required. 

File support for each unique trunk name operates independently. That is, 
file support for multiple trunk names operates as if the trunk names were 
defined on separate DIs. Commands addressed to the Independent File 
Access ME for one trunk do not affect the Independent File Access ME for 
other trunks. 

Format DEFINE _FILE .SUPPORT 

FILEJTYPE = list 1..8 of keyword value 
TRUNK_FAME = name 

Parameters FILEJTYPE or FILE JTYPES (FT) 

File types accessible through this DI. Files can be specified as a list of one 
or more of the following keyword values: 



Keyword Value 



Description 



EXCEPTION 

BOOT 

DUMP 

LIBRARY 

CONFIGURATION 

TERMINAL JPROCEDURE 

USER .PROCEDURE 

LOAD.PROCEDURE 

ALL 

Default is ALL. 



Exception list 

Boot files for DIs 

DI dump files 

CDCNET DI object library files 

DI configuration files and procedures 

Terminal definition procedures 

Terminal user procedures 

CDCNET load procedures 

All file types 



TRUNK JXAME (TN) 

Trunk name of the logical link used for the file access connection. If 
TRUNK .NAME is not specified, the default trunk is used. The default 
trunk is specified on DEFINE .SYSTEM. Default is the channel over which 
the DI was loaded. If the DI was not loaded over a channel and no default 
channel trunk was specified on DEFINE .SYSTEM, no default channel 
trunk exists. 
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Responses Pile Support is defined for trunk <name>. 

-WARNING- File Support is defined for trunk <name>. NP interface for 
the trunk is started but the logical link is down. 

-WARNING- File Support is defined for trunk <name>. NP interface for 
the trunk is not started. Start NP interface to enable file support. 

-ERROR- NP interface is not defined for trunk <name>. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-ERROR- File Support for trunk <name> is already defined. 

-FATAL- File Support cannot be defined for trunk <name>. Not enough 
memory is currently available for required table space. 

-FATAL- File Support cannot be defined for trunk <name>. Unable to 
initialize the File Support function. 

Remarks This command can be used to redefine the default file type support of an 
MDI/MTI loaded across an MCI. The first time file support is redefined for 
the DI load media, you do not receive the following error message: 

-ERROR— File Support for trunk <name> is already defined. 

The above error message appears during subsequent attempts to redefine 
file support. If this command is in the DI's configuration file, it redefines 
the default file type support of a DI loaded across an MCI. However, this 
command does not redefine file support if entered through the Network 
Operator Utility (NETOU). To redefine file support via NETOU, first 
cancel file support for all file types using CANCEL _FILE_SUPPORT. 
Then, redefine desired file types using DEFINE _FILE _SUPPORT. 

Examples def 1ne_f 1 le_support f1le_types=(except1on, boot. library) 

File Support 1s defined for trunk exception, boot, library. 
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DEFINE JHDLC JSTET (DEFHN) 

DI Configuration Procedure/NETOU Command 

Purpose Configures a CDCNET HDLC network solution using a previously defined 
HDLC trunk, or several HDLC trunks. An "unable to start" error leaves 
the network defined but not started. 

Format DEFINE _HDLC _NET 

TRUNK .NAME = list 1..32 of name 
NETWORK _ID = 1..0FFFF(16) 

NETWORK^NAME = name 

COST = 0..7FFFFFFF(16) 

RELAY _ALLOWED = boolean 

ROUTING _INFO NETWORK = boolean 

START = boolean 

ARCHITECTURE JTYPE = list 1..2 of keyword value 

OUTPUT _QUEUE _LIMIT = 10000..500000 

INCOMING _SERVICE ^ACCESS = list 1.11 of keyword value 

OUTGOING _SERVICE _ACCESS = list 1..11 of keyword value 

Parameters TRUNK _NAME (TN) 

Logical name of the HDLC trunk or trunks used for the network solution. 
If more than one trunk name is specified, the logical name is a 
combination of all specified trunks. The trunk or trunks named by this 
parameter must be configured before this command executes. 

NETWORK _ID (NI) 

CDCNET network identifier of the HDLC network solution. The network 
ID must be unique within the catenet. 

NETWORK ^NAME (NN) 

Logical name of the network solution used in subsequent commands 
referencing the network solution. The default name is constructed from the 
NETWORK _ID parameter, using the format $NET_xxxxx, where xxxxx is 
the network ID expressed in decimal. For example, a network ID of 200 
results in a default name of $NET_200. 

COST (C) 

Relative cost of the HDLC network solution as a path for routing data 
through the network. The cost of a network is calculated by dividing 100 
million by the sum of the trunk data rates in bits per second. For 
example, the cost of a trunk with a speed of 56000 bits per second is 
06FA(16). If the cost specified is greater than 0FFFFQ6), 0FFFF(16) is 
used for for compatibility reasons. If the COST parameter is not specified, 
it is calculated by dividing 100 million by the sum of the speeds of the 
specified trunks. If the trunk speed specified on DEFINE _HDLC_TRUNK 
is 1200, default is 0FFFFU6). 

If the COST parameter is specified, the cost of the specified network is 
static. If it is not specified, the cost is dynamic. 

CDCNET routing uses cost to determine the least-cost routes for 
interconnecting networks. If multiple paths are available, the least- cost 
path is used. As a network becomes congested, its cost increases. 



60000414 D 



DEFINE Commands 6-23 



DEFINE _flDLCJ«ET (DEPHN) 



RELAY ^ALLOWED (RA) 

Whether or not the DI can use this network for relaying traffic through 
the DI. Possible values are TRUE, relay allowed; and FALSE, relay not 
allowed. Default is TRUE, relay allowed. 

If RA is TRUE, the DI relays traffic between this network and other 
connected networks regardless of the definition of the other networks. If 
RA is FALSE, the DI still relays traffic between this network and any 
connected networks defined with RA=TRUE. If RA is FALSE, the DI 
system does not relay traffic between this network and other connected 
networks defined with RA= FALSE unless no other nonrestricted route 
exists between the networks. 

The following example illustrates these rules. 



Network A DI Network B 

RA=FALSE RA=TRUE 




Network C 
RA=FALSE 



Relay Between; Allowed/Not Allowed: 



Network A and Network B Allowed (RA is TRUE for Network B). 

Network A and Network C Not allowed (RA is FALSE for both is 

FALSE for both Network A and 
Network C). 

Network B and Network C Allowed (RA is TRUE for Network B). 

ROUTING _JNFO_NETWORK (RIN) 

Whether or not the network solution carries CDCNET routing information. 
Routing information pertains both to the proprietary CDCNET IS-IS 
routing protocol, as well as the ES-IS routing protocol. If RIN is TRUE, 
the DI sends routing information describing all the networks to which the 
DI connects over this network solution. If RIN is FALSE, the DI does not 
send routing information over the network solution. The DI appears 
unconnected to any network other than this network solution. Default is 
TRUE. 

START (S) 

Whether or not network starts after configuration. Default is TRUE. 

ARCHITECTURE JTYPE (AT) 

This parameter is no longer supported. Specification is valid but the value 
is ignored. 

OUTPUT JQUEUE JLIMIT (OQL) 

Maximum data, in bytes, retained in the output queue for the network 
solution if the DI's operating system buffer queue state is poor or worse. If 
messages must be discarded, newest output messages are discarded first. 
Default depends on network cost (see COST parameter). If the cost is 
6FA(16) or more, default is 30000 bytes. Otherwise, default is 60000 bytes. 
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INCOMING .SERVICE _ACCESS (ISA) 

Specifies which services may be accessed coming in via the network 
solution. The keyword values are: 



Keyword Value 



ALL 

NONE 

application 

batch _support 
interactive 



nos ..interactive 
passthrough 



t_passthrough 



Description 



All services are allowed. 

No services are allowed. 

Any service not identifiable by keyword 
batch _support, interactive, file ..transfer, 
or network ..management. 

Any batch input and output services are 
allowed. This includes batch control 
facility, batch job submittal, and batch 
output. 

All interactive services are allowed. 
Interactive service supports terminal user 
access. Specifying this keyword is the 
same as specifying all of the following 
interactive service keywords: nos_ 
interactive, passthrough, t_passthrough, 
user_telnet, x25 ..terminal _gw, and ve_ 
interactive. 

All interactive services provided by NOS 
mainframes are allowed. 

All site- defined passthrough services are 
allowed. A site-defined passthrough service 
is provided when a passthrough title is 
created during the execution of a 
Terminal User Procedure (TUP) when a 
line is activated. This service allows 
asynchronous interactive devices to make 
connections to passthrough titles of this 
type through asynchronous ports and to 
exchange information using CDCNET's 
transparent data feature. 

All user- defined passthrough services are 
allowed. A user- defined passthrough 
service is provided when an interactive 
terminal user creates a connection to the 
interactive passthrough server, and defines 
a passthrough title either by entering the 
required commands manually or by 
executing a Terminal User Procedure 
(TUP) via the DO command on the 
$CDCNET_COMMAND connection. 
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Keyword Value 



Description 



user_telnet 



x25 _terminal _gw 



ve_interactive 



file_transfer 



network _management 



Default is ALL. 



This service allows asynchronous 
interactive devices to make connections to 
passthrough services of this type through 
asynchronous ports and exchange 
information using CDCNET's transparent 
data feature. 

All TELNET services are allowed. User 
TELNET is an interactive service which 
provides CDCNET terminal users with 
access to the interactive services of remote 
hosts on a TCP/IP network. 

All X.25 terminal services are allowed. 
The X.25 terminal gateway is an 
interactive service which provides 
CDCNET asynchronous terminal users 
with access to the interactive services of 
remote hosts on an X.25 network. 

All interactive services provided by 
NOS/VE mainframes are allowed. 

All QTF/PTF file transfer services are 
allowed. File transfer services support 
user file (PTF) and queue file transfers 
(QTF). 

All network alarm, clock, command, file, 
and log services are allowed. 



OUTGOING ^SERVICE ^ACCESS (OSA) 

Specifies which services may be accessed going out via the network 
solution. See the ISA parameter for the keyword value options. 

Responses HDLC network < network _name> defined for trunk < trunk _name> 

HDLC network < network _name> defined for trunk(s) < trunk _name>, 
< trunk _name > .. . 

HDLC network < network _name> defined and started for trunk < trunk _ 
name> 

HDLC network < network _name> defined and started for trunk(s) 
< trunk __name>, < trunk _name>... 

-WARNING- The 3A Command Processor has timed out waiting for 
response from SSR. Please check network status for completion of request. 

-ERROR- Network < network _name> already defined for trunk < trunk _ 
name>. 

-ERROR- Trunk < trunk _name> is not defined. 
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-ERROR- Trunk < trunk _name> is not an HDLC trunk. 

—ERROR- Network name <network_name> already defined. 

-ERROR- Network id < network _id> already defined. 

-ERROR- Different traffic _type values are configured for the trunks 
associated with the HDLC network solutions. All trunks associated with a 
single network solution must be configured with the same value for the 
traffic _type parameter. 

-ERROR- Trunk < trunk _name> is down. Unable to start network 

< network _name > . 

-ERROR- Trunk < trunk _name> is off. Unable to start network 

< network _name > . 

-ERROR- NETWORK <name> is the boot source. < Parameter > cannot 
be redefined. 

-ERROR-Network < network _name> already defined for 

trunk <trunk_name> by the boot source. 

Network id is < network _id>. 

The command network id is < network _id>. 

Please reenter the command with correct network id. 

-FATAL- Not enough memory is currently available for required table 
space. 

-FATAL- Unable to start task < entry _point_name>. 

-FATAL- Stream Service error. HDLC SSR received error when sending 
command to DVM. 

-FATAL- Stream Service error. HDLC SSR received error on start port 
services. 
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Remarks Use multiple trunk networks instead of several single trunk networks when 
several HDLC trunks run between two DIs to reduce network overhead. 
Traffic is more equally distributed between multiple trunks. 

When executed for the HDLC trunk over which the DI boot was received, 
this command redefines the network with the specified options. To redefine 
the HDLC network over which the DI was booted, this command must be 
in the configuration file. 

Currently, redefinable options are as follows: 

NETWORK _NAME 

COST 

RELAY_ALLOWED 

ROUTING. INFO_NETWORK 

OUTPUT_QUEUE _LIMIT 

INCOMING_SERVICE .ACCESS 

OUTGOING. SERVICE .ACCESS. 

For an HDLC network which loads a DI to operate as a multiple-trunk 
network, that network solution must be redefined during configuration, 
specifying the associated trunks. 

Examples In this example, an HDLC trunk links two separate sites (figure 6-2). 
Assume that interactive connections and QTF/PTF file transfers are 
permitted both ways between the two networks. But other services are not 
allowed. Here, you define service access with the DEFINE_HDLC.NET 
command. 

Add the following to the configuration file for NDI.l: 

def1ne_hdlc_net .. 

trunk_name=hdlc_trunk_1 ,network_name=name='hdlc_NET_1 . . 
network_1d=3. . 

1ncoming_service_access=(file_transfer, interactive). . 
outgoing_serv1ce_access=(file_transfer, Interactive) 

Add the following to the configuration file for NDI.21. 

define_hd1c_.net . . 

trunk_name=hd1c_trunk_1,network_name=hd1c_net_1. . 
network_id=3. . 

1ncom1ng_service_access=(fne_transfer, interactive)., 
out go 1 ng_serv1 ce_access= ( f 1 1 e_t ransf er , 1 nteract i ve) 

Note that only one side of the link needs to specify the service access 
restrictions. But defining restrictions on NDI.l and NDI.21 prevents an 
operator on either side from changing the configuration to gain 
unauthorized access to services. 
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HOST 1 



MDI 1 



/- 



TDI 1 



NDI 1 



NDI 21 



/- 



TDI 21 



TDI 22 



TDI 2 



SITE1 



-^ESCI_NET_1 



- - HDLC_NET_1 4f----------------------- 

SJIL2 



ESCI NET 2 



MDI 23 



HOST 2 



M04137 



Figure 6-2. DEFHN Example 
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DEFINE _HDLC JTRUNK (DEFHT) 

DI Configuration Procedure/NETOU Command 

Purpose Configures an HDLC trunk. 

Format DEFINE .HDLC .TRUNK 

LIM = 0..7 
PORT = 0..3 

TRUNKJSTAME = name 
LOCAL .ADDRESS = 1..255 
REMOTE .ADDRESS = 1..255 

OPTIONS = list of 1..6 of keyword value 

MAX_UNACK_FRAMES = 0..127 

SREJ_QUEUE_SIZE = 0..7 

MAX_JRAME_SIZE = 132..32768 

PF RECOVERY JTIMER = 500..65535 

ERROR JRECOVERYJTIMER = 500..65535 

RETRANSMISSION JLIMIT = 1..65535 

TRUNK JSPEED = 1200..256000 

CLOCKING = keyword value 

INTERACTIVE JBANDWIDTH = 1..9 

DRIVER = keyword value 

TRAFFIC _TYPE = keyword value 

UNSTABLE JTRUNK ^DISCONNECT JTIMER = 0..65535 

Parameters LIM (L) 

LIM number for the port to which the HDLC trunk connects. 

PORT (P) 

Port number for the port to which the HDLC trunk connects. 

TRUNK J^AME (TN) 

Logical name of the HDLC trunk. The default name is constructed using 
the LIM and PORT parameters, as in $LIM1_P0RT3. 

LOCAL .ADDRESS (LA) 

Address of the local HDLC station. LOCAL .ADDRESS is always 3 if the 
DI is loaded via the HDLC trunk. 

REMOTE .ADDRESS (RA) 

Address of the remote HDLC station. REMOTE _ADDRESS is always 1 if 
the DI is loaded via the HDLC trunk. 

NOTE 

The service DI (the DI providing support for loading, configuring, and 
dumping a Remote Terminal Interface (RTI)) must configure the HDLC 
trunk using 1 for the LOCAL .ADDRESS and 3 for the REMOTE. 
ADDRESS. Any other values for these addresses disable the reconnection of 
the RTI and the service DI, if the service DI is reset. 
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OPTIONS (0) 

List of standard HDLC options the trunk supports. Allowed keyword values 
include the following: 



Keyword Value 



REJ_ON 

REJ_OFF 
SREJ_ON 

SREJ_OFF 

UI_ON 



UI_OFF 
SIM_ON 

SIM_OFF 
RESET_ON 



Description 



RESET_OFF 



Includes a reject (REJ) code in the HDLC control 
field. REJ indicates detection of a transmission 
error and requests retransmission of information 
frames. 

Does not include a REJ code in the HDLC control 
field. 

Includes a selective reject (SREJ) code in the 
HDLC control field. SREJ requests retransmission 
of only the information frame specified. 

Does not include a SREJ code in the HDLC 
control field. 

Includes an unnumbered information (UI) code in 
the HDLC control field. UI transfers 
nonsequence-numbered information fields, such as 
higher level status and link initialization data, 
across a link. Reception of Ul-labeled information 
frames is not verified by sequence number. 

Does not include a UI code in the HDLC control 
field. 

Includes a set initialization mode (SIM) code in 
the HDLC control field. SIM starts system-specific 
initialization procedures at the remote station. 

Does not include a SIM code in the HDLC control 
field. 

Includes a reset code in the HDLC control field. 
Reset is transmitted by a combined station, and 
resets the receive state variable and frame reject 
(FRMR) condition in the addressed combined 
station. FRMR reports unrecoverable error 
conditions by retransmitting the frame in error. 
Example error conditions include an invalid 
command, an information field exceeding 
maximum length, and an invalid receive sequence 
number. 

Does not include a reset code in the HDLC control 
field. 
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Keyword Value 



Description 



IFRAME_ON 



IFRAME_OFF 



Includes an information frame (IFRAME) code in 
the HDLC control field. IFRAME transfers 
sequentially numbered frames, including user 
information, across the data link. Counts are kept 
for the frame number being sent and the frame 
number expected to be received next. Stations 
continually report these counts to each other 
during information exchange. 

Does not include an IFRAME code in the HDLC 
control field. 



Default HDLC options list is (REJ_ON, SREJ_ON, UI_ON, SIM_ON, 
RESET_ON, IFRAME _ON). 

MAX_UNACK_FRAMES (MUF) 

Maximum frames the local station can send without receiving an 
acknowledgement. The maximum number of frames that can be configured 
is 127. Default is 7. 

SREJ_QUEUE_SIZE (SQS) 

Size of the queue for holding frames received out of sequence and held by 
HDLC SSR pending receipt of missing frames whose transmission has been 
requested via the SREJ. Default is 7. 

MAX _FRAME _SIZE (MFS) 

Maximum frame size, in bytes, for a transmitted or received HDLC frame. 

The value of this parameter must be coordinated with the value of the 
MAX_ DATAGRAM _SIZE parameter in the DEFINE _IP_NET command 
when MFS is used to configure an IP network over this HDLC trunk. 
Default is 1500. 

PFJZECOVERYJTIMER (PRT) 

P/F recovery timer value in milliseconds. This timer initiates P/F recovery 
when an acknowledgement is not received for an IFRAME in this time. 
Default is 500. 

The following table shows best values for PF_RECOVERY_TIMER and 
ERROR _RECOVERY_TIMER (see following parameter description) values, 
based on trunk speed. 

tliseconds) ERT (milliseconds) 

65535 

65535 

48000 

24000 

12000 

6000 

4500 

3000 

3000 

3000 

3000 



Trunk Speed 


PRT I 


1200 


32000 


2400 


16000 


4800 


8000 


9600 


4000 


19200 


2000 


38400 


1000 


48000 


750 


56000 


500 


64000 


500 


128000 


500 


256000 


500 
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ERROR RECOVERY JTIMER (ERT) 

Error recovery timer value in milliseconds. This timer determines if P/F 
recovery has failed and initiates the next recovery level. Default is 3000. 

The Network Configuration Utility (NETCU) uses the TRUNK _SPEED 
parameter value to determine P/F and error recovery timer values (see 
previous parameter description). 

RETRANSMISSION _LIMIT (RL) 

Maximum retransmissions allowed for a given control frame. Default is 5. 

TRUNK JSPEED (TS) 

HDLC trunk speed in bits per second. The DI uses trunk speed to generate 
data clocking for the trunk (except when clocking is EXTERNAL), and to 
configure the media with proper network cost and output queue limit 
values. NETCU uses trunk speed to set PF_RECOVERY_TIMER and 
ERROR _RECOVERY_TIMER parameter values (see PF_RECOVERY_ 
TIMER parameter description). Values for this parameter include: 

1200 

2400 

4800 

9600 

19200 

38400 

48000 

56000 

64000 

128000 

256000 

Default is 56000. Specifying a trunk speed differing from the actual speed, 
even if you have specified EXTERNAL clocking, results in suboptimal 
performance. If clocking is external, trunk speed is used only to calculate 
network cost. 

CLOCKING (C) 

Whether the LIM internally generates the clock signal for data on this 
trunk or uses an externally generated clock signal. If the LIM generates 
the data clock signal, the clocking rate is derived from the TRUNK _ 
SPEED parameter. Allowed keyword values include EXTERNAL and 
TRANSMIT. 
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Keyword Value 



Description 



EXTERNAL LIM derives data clocking for both receive and 

transmit data from external signals (TRUNK _ 
SPEED is then informational only). The 
EXTERNAL receive data clock is derived from the 
RS-232 DD circuit for RS-232 ports or the RS-449 
SR circuit for RS-449 ports. The EXTERNAL 
transmit data clock is derived from the RS-232 
DB circuit for RS-232 ports or the RS-449 ST 
circuit for RS-449 ports. 

TRANSMIT LIM generates clocking for transmit data, but 

derives clocking for receive data from an external 
source. The transmit data clock matches the trunk 
speed specified for the trunk. The LIM supplies 
the transmit data clock on the RS-232 DA or 
RS-449 TT circuit. The LIM derives the receive 
data clock from the RS-232 DD or the RS-449 SR 
circuit. 

Default is EXTERNAL. 

Clocking should be TRANSMIT for HDLC trunks connected directly 
between DIs (without intervening modems). Clocking should be EXTERNAL 
for HDLC trunks with modems. 

For data clocking to work, LIMs supporting HDLC trunks must have the 
appropriate hardware configuration, and the CLOCKING parameter must 
be set. 

INTERACTIVE JBANDWIDTH (IB) 

Percentage of the trunk bandwidth used for transmitting data at 
interactive priority. Default is 7. For example, an interactive bandwidth 
value of of 7 results, on average, in 70 bytes of interactive priority data 
for every 30 bytes of batch priority data. 

DRIVER (D) 

Specifies the type of HDLC driver. Allowed keyword values include the 
following: 



Keyword Value 



Description 



HDLC .NORMAL 



HDLC256 



HDLC3x64 



Operates with other line types on the same CIM. 
It operates one HDLC line at 64 K bits per 
second and a combination of HDLC lines not 
exceeding 22,000 characters per second. 

Operates one HDLC line at 128 K bits per second 
or 256 K bits per second on a dedicated CIM. 

Operates one to three HDLC lines at speeds up to 
64 K bits per second per line on a dedicated CIM. 



Default is HDLC_NORMAL. 
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TRAFFIC JTYPE (TT) 

Specifies the type of traffic used for this trunk. It also controls the use of 
the CDCNET proprietary Intranet header in data units transmitted on this 
trunk. Allowed keyword values include the following: 



Keyword Value 



Description 



CDCNET 



NON _CDCNET_OSI 



NON_CDCNET_IP 



Used when the HDLC trunk connects two 
CDCNET systems. Each data unit transmitted 
includes the Intranet header. There is no 
restriction on the type of traffic which may be 
transmitted on this trunk. 

Used when the HDLC trunk connects a CDCNET 
system to a non-CDCNET OSI system. Data units 
transmitted do not include the Intranet header. 
This trunk can only be used to transmit traffic 
generated by the OSI network layer. Traffic 
received on this trunk is delivered at the OSI 
Network layer's Intranet SAP. 

Used when the HDLC trunk connects a CDCNET 
system to a non-CDCNET TCP/IP system. Data 
units transmitted do not include the Intranet 
header. This trunk can only be used to transmit 
TCP/D? traffic. Traffic received on this trunk is 
delivered at the IP's Intranet SAP. 



Default is CDCNET. 



UNSTABLE JTRUNK DISCONNECT JTIMER (UTDT) 

Specifies the time, in seconds, that an unstable HDLC trunk is logically 
disconnected from a network solution. A trunk is considered unstable when 
it has gone into an inoperable state more than 3 times hi the last 5 
minutes, or 6 times in the last 30 minutes. 

A value of disables this feature. Default is 0. 

Responses HDLC trunk < trunk _name> defined. 

-ERROR- Trunk name < trunk _name> already defined. 

-ERROR- LIM x, PORT y is not installed in this system. 

-ERROR- LIM xx, PORT xx addresses a port that cannot be serviced. 
More than 48 ports are attached to CIMxx. Ports beyond the 48th port 
attached to a CIM are not serviced. 

-ERROR- Not enough CIM memory available to load xxx I/O Processor. 

-ERROR- Specified LIM, PORT is already in use: 

-ERROR- Specified LIM, PORT is not on. 

-ERROR- Line_speed < integer > is not supported for an HDLC trunk. 

-ERROR- HDLC is not supported on the specified LIM. 
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-ERROR- TRUNK <name> is the boot source. < Parameter > cannot be 
redefined. 

-ERROR- A line or trunk that is already defined is serviced by the same 
CIM as this trunk. The hdlc256 driver requires the CIM to be dedicated to 
this trunk. 

-ERROR- A line that is already defined is serviced by the same CIM as 
this trunk. The HDLC3X64 driver requires the CIM to be dedicated to 
HDLC or X.25 trunks. 

-ERROR- A trunk that is already defined for driver < driver > is serviced 
by the same CIM as this trunk. A CIM can only support one HDLC driver. 

-ERROR- Three HDLC or X.25 trunks that are already defined are 
serviced by the same CIM as this trunk. The hdlc3X64 driver cannot 
support more than three trunks. 

-ERROR- The DI was loaded via this HDLC trunk and the CIM switch 
setting specified the hdlc256 driver. The driver cannot be changed to hdlc_ 
normal or hdlc3x64 since these drivers do not handle high line speeds and 
communication could be lost. 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks This command is required only in DIs configured with an HDLC trunk. 

This command is not required in systems booted over the HDLC trunk. If 
this command executes for the HDLC trunk over which the DI boot was 
received, it redefines the trunk with the specified options. To redefine the 
HDLC trunk over which the DI was booted, this command must be in the 
configuration file. 

Currently, redefinable options are as follows: 

TRUNK _NAME 
PF_RECOVERY_TIMER 
ERROR_RECOVERY_TIMER 
RETRANSMISSION _LIMIT 
TRUNK .SPEED 
INTERACTIVE .BANDWIDTH 

Examples def1ne_hdlc_trunk Hm=5,port=0, local _address=1,remote_address=26 

HDLC trunk Hm5_port0 defined. 
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DEFINE JNETD 

INETD Configuration File Command 

Purpose Defines the Internet Daemon (INETD) application. 

This command is valid only in file $SYSTEM.TCP_IP.INETD_ 
CONFIGURATION. Do not use this command in a DI configuration 
procedure. 

Format DEFINE .INETD 

SERVICE = name 

MANTA .FILE .NAME = file 

Parameters SERVICE (S) 

Service name. 



Examples 



MANTA .FILE .NAME (MFN) 

Name of the file used for communication between MANTA and INETD. 
File is created by INETD during initialization. 

def1ne_1netd .. 

service=inetd . . 

manta_f 1 le_name=$SYSTEM.TCP_IP. INETD_MANTA_SERVICE_FILE 
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DEFINE _IP_HOST (DEFIH) 

DI Configuration Procedure/NETOU Command 

Purpose Configures an Internet Protocol (IP) host address and associated static 
routing information, such as the Ethernet system identifier and header 
format. DEFIH also configures IP host addresses for Address Resolution 
Protocol (ARP). If an IP host address is configured with an Ethernet 
address (system identifier), ARP does not send a request packet. If the IP 
host address is not configured, ARP broadcasts a request packet on the 
LAN to determine the Ethernet address. A configured IP host address 
routing entry never times out. However, the IP host address routing entry 
(learned and created by ARP) times out after 1 hour of inactivity. 

DEFIH can be used to configure an ARP agent. If a DI is to respond to an 
ARP request for an IP address configured as an ARP agent, it responds 
with the configured Ethernet address. 

An IP address must be configured for the following: 

• The DI, one address for each directly connected IP network (IP_ 
HOST = LOCAL). 

• All CYBERs this DI supports (HOST_TYPE=CDC_HOST). 

• Hosts or gateways that do not support ARP (HOST_TYPE = IP_HOST, 
IP_GW, IP_HOST_AGENT, or IP_GW_AGENT). 

A DEFIH command is not required for: 

• Any DI or host that does not use TCP/IP protocols. 

• Any TCP/IP host that providing ARP services. 

Format DEFINE _IP_HOST 

IP_ADDRESS = list 4 of 0..255 

HOST_TYPE = keyword value 
SYSTEM JD = list 2 of O..OFFFFFF(16) 
LAN _HEADER JFORMAT = keyword value 

Parameters IP_ADDRESS (IA) 

IP address of the host/workstation/PC to be configured. The network 
number portion of the IP address must be previously defined by DEFINE _ 
IP_NET. The format is similar to the decimal octet convention used by 
TCP/IP, except periods are replaced with commas and the list is enclosed 
in parentheses. For example, the IP address 128.2.53.7 is represented as 
(128,2,53,7). 
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HOSTJTYPE (HT) 

Host type associated with the configured address. The following types are 
allowed: 



Keyword Value Description 



LOCAL (L) 



CDC_HOST (CH) 



The IP address refers to the DI you are configuring 
and is the default IP address for this DI. The IP 
address is the source address IP uses if upper layer 
protocols, such as TELNET, do not specify a source 
address. (There must be only one IP address of host 
type LOCAL configured for each IP network to which 
a DI physically connects.) If an ARP request is 
received for an IP address configured as LOCAL, the 
DI responds with the DI's Ethernet address. This IP 
address is used as the source IP address in ARP 
request and reply packets. 

The IP address refers to an alternative address for 
this DI. That is, it is another IP address for this DI, 
besides the LOCAL host type IP address. A DI can 
have several IP addresses. Of these addresses, only 
one can be type LOCAL for each connected IP 
network; all others must be type CDCJHOST. For 
every CYBER this DI accesses and/or services, there 
should be a DEFIH with host type CDC_HOST. If an 
ARP .request is received for an IP address configured 
as CDC_HOST, the DI responds with the DI's 
Ethernet address. 
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Keyword Value Description 



IP_HOST (IH) 



IP_GW (IG) 



The IP address refers to a host that is not the local 
DI. IPJHOST defines other IP hosts on an Ethernet 
network directly connected to the DI, so an IP address 
can map to a physical Ethernet system identifier, and 
vice versa. Other IP hosts need not be defined if: 

• Their network is physically addressed by the IP 
address (for example, MILNET and ARPANET are 
physically addressed by the IP address). 

• The IP network is not physically connected to the 
DI but is reached by a gateway. 

• ARP determines IP address/Ethernet address 
mapping. 

The IP address refers to a gateway that is not the 
local DI. This type is like IP_HOST, except IP_GW 
further specifies the host is a gateway that can be a 
route to another IP network. If ARP is active, an IP 
gateway need not be defined. 

The DI acts as an ARP agent for the configured IP 
address. When an ARP request packet is received for 
this IP address, the DI responds with the configured 
Ethernet address. 

The DI acts as an ARP agent for the configured IP 
address. When an ARP request packet is received for 
this IP address, the DI responds with the configured 
Ethernet address. Requesting systems on a LAN use 
IP_GW_AGENT host type to reach remote networks. 
The DI supplies the Ethernet address to these 
systems. 

Default is IP_HOST. 

SYSTEM JD (SI) 

Ethernet address or CDNA system identifier of the host. This value is a 
48-bit address, specified as a list of two 24-bit integers. For example, the 
Ethernet address 080025212345(16) is entered as (080025(16), 212345(16)). 
You can omit this parameter for hosts not on Ethernet media or for host 
types LOCAL or CDC .HOST. 



IP_HOST_ 

AGENT (IHA) 



IP_GW_AGENT 
(IGA) 
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LAN _HEADER JFORMAT (LHF) 

Local area network (LAN) header format used at the configured address. 
Ignored for host types LOCAL or CDC_HOST. The following values are 
allowed: 



Keyword Value 



Description 



STANDARD. 
HEADER (SH) 

XNS .HEADER (XH) 



Host uses an IEEE 802.2 Ethernet header. This is 
the standard for CDCNET. 

Host uses a Xerox Networking Software (XNS) 
Version 2 Ethernet header. All older and many 
recent TCP/IP implementations use this header 
format. 

IEEE _XNS .HEADER Host uses an IEEE 802.2 Ethernet header with a 
(IXH) SNAP header to encapsulate XNS information. 

This is the new TCP/IP header format. However, 
most existing implementations use the older 
XNS .HEADER. Check vendor's documentation to 
determine which header is required. 

Default is STANDARD.HEADER. 

Responses IP host address <ip .address > is defined. 

-ERROR- IP host address <ip .address > is already defined. 

-ERROR- IP network < network .address > is not defined. 

-ERROR— IP subnet < subnet .address > is not defined. 

-ERROR- IP address <ip .address > is invalid. 

-ERROR- System id is required for host .type of IP.HOST, IP.HOST. 
AGENT, IP.GW, and IP.GW.AGENT. 

-ERROR- HOST.TYPE of LOCAL is already defined for network 
< network .address > . 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_ip_host ip_address = (128,5,0,3) .. 

host_type = 1p_host 1an_header_format ■ xns_header .. 
system_1d = (020701(16), 009ec9( 16)) 



IP host address 128.5.0.3 1s defined. 
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DEFINE _IP_NET (DEFIN) 

DI Configuration Procedure/NETOU Command 

Purpose Configures an Internet Protocol (IP) network/subnet and associated routing 
information. An IP network/subnet address must be configured for every 
directly connected IP network/subnet, and for every indirectly connected IP 
network/subnet that cannot be learned via ARP, RIP, or EGP. If the IP 
network/subnet is directly connected, the physical network/subnet must be 
previously defined by the following commands: DEFINE _ETHER_TRUNK 
and DEFINE _ETHER_NET (for Ethernet networks), DEFINE _X25_ 
TRUNK and DEFINE _X25 .INTERFACE commands (for X.25 networks), 
or DEFINE _HDLC_TRUNK and DEFINE _HDLC_NET (for HDLC 
networks). 

If at least one Ethernet trunk is configured as an IP network/subnet, ARP 
is loaded and configured into the system. 

Format DEFINE _IP_NET 

IP_NETWORK = list 1..4 of 0..255 

JP_ADDRESS = list 4 of 0..255 

HOPJCOUNT = 0.255 

MAX _DATAGRAM _SIZE = 20..1500 

TRUNK_NAME = name 

ARP JLAN READER _FORMAT = list 1..2 of keyword 

SUBNET _MASK_SIZE = 10..30 

OFFER JREVERSE _ARP_SERVICE = boolean 

ENABLE _IPJBRO ADC AST = boolean 

Parameters IP_NETWORK (IN) 

IP network number part of the IP address of the network to be configured. 
If IP_NETWORK is zero, any datagram to an IP network not in the 
routing tables is sent to the gateway specified by the IP_ADDRESS 
parameter. This is known as the default route. 

The parameter format is similar to the decimal octet convention used by 
TCP/IP, except periods are replaced with commas and the list is enclosed 
in parentheses. One, two, or three values between commas must be 
specified for Class A, B, or C networks, respectively. If this network is 
subnetted, the specified values must be consistent with the subnet mask 
size. For example, IP network 192.2.53.0, which is not subnetted, is 
represented as (192,2,53,0) or (192,2,53). IP network 129.179.0.0, which is 
subnetted and has a subnet mask size of 24 bits, is represented as 
(129,179,10,0) or (129,179,10), where 10 is the subnet number. 

IP_ADDRESS (IA) 

IP address of the next gateway (hop) in the route to the destination IP 
network. To reach the destination IP network, this host must previously be 
configured by a DEFINE _IP_HOST command or learned by ARP. The 
format is similar to the decimal octet convention used by TCP/IP, except 
periods are replaced with commas and the list is enclosed in parentheses. 
For example, the IP address 128.2.53.7 is represented as (128,2,53,7). 
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HOPJCOUNT (HC) 

Specifies the number of hops or gateways traversed to reach this 
configured IP network. If the hop count is zero, the network is a directly 
connected network and the TRUNK _NAME parameter (description follows) 
must also be specified. Default is 0. 

MAX _PATAGRAM JSIZE (MDS) 

Specifies the maximum datagram size, in bytes, that the IP network 
handles without fragmentation. If the hop count is nonzero, also consider 
the maximum size of intervening IP networks to avoid fragmentation. This 
applies only to directly connected networks. 

The value of this parameter must be coordinated with the maximum frame 
size configured for the underlying trunk. The value must be smaller than 
the maximum frame size by at least 4 bytes. 

Default is 576 bytes for DDN networks and 1500 bytes for Ethernet 
networks. 

TRUNK J^AME (TN) 

CDCNET trunk name of a directly connected network. The name must 
have been previously specified on DEFINE _ETHER_TRUNK, DEFINE _ 
HDLC_TRUNK, or DEFINE _X25 _TRUNK. If the value of the HOP_ 
COUNT parameter is zero, this parameter is required; otherwise it is 
ignored. 

For multiple trunk HDLC networks, any one trunk name from the list 
specified in the DEFINE _HDLC _NET command may be entered. The IP 
network/subnet utilizes all trunks defined for the associated HDLC network 
solution. 

ARPJLAN JIEADER JFORMAT (ALHF) 

Ethernet header format for ARP request packets. The following keyword 
values are allowed: 

Keyword 

Value Description 

" ' "" ■■—■■■ — ■ 1^1 ■ ■ ■■ ^ . I .1 II . H I.!. I.. I — I || ■ | .,., — .1 .-III I- 

XNS_ ARP request packets use Xerox Networking Software 

HEADER (XNS) Version 2 Ethernet header. All older and many 

(XH) recent TCP/IP implementations use this header format. 

IEEE_XNS_ ARP request packets use IEEE 802.2 Ethernet header with 
HEADER a SNAP header. This is the new TCP/IP header format. 

(IXH) However, most existing implementations use the older 

XNSJHEADER. Check vendor's documentation to 

determine which header is required. 

Default is XNS .HEADER. If both header formats are specified, two ARP 
request packets are sent at the same time, one with an XNS header and 
the other with the 802.2 with SNAP header. 
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SUBNET _MASKJSIZE (SMS) 

Whether or not the IP network is subnetted. Subnet mask size is the bits 
in the subnet mask. For subnetting to occur, the subnet mask must be at 
least 10, 18, or 26 bits for Class A, B, or C networks, respectively. The 
subnet mask size must be the same for all subnets of a given IP network. 
If the IP network is subnetted (by a previously issued DEFINE .IPJSTET) 
and this parameter is omitted, the previously defined subnet mask size is 
used. Otherwise, the IP network defined by this command is not subnetted. 

OFFER JREVERSE_ARPJSERVICE (ORAS) 

Specifies whether or not the IP network is to be activated as a reverse 
ARP (RARP) Server, servicing RARP requests from all hosts in the directly 
connected network. 

There must be at least one RARP Server defined for each LAN in order to 
provide RARP services. Since all RARP Servers defined through this 
command are of equal status, they all respond to RARP requests. To 
reduce the probability of collisions, do not define a large number of RARP 
Servers. Define at least two RARP Servers on each LAN to provide higher 
reliability, in case one RARP Server is down. Defining multiple RARP 
Servers implies entering DEFIN commands for multiple DIs on a single 
LAN. 

ENABLE _JP_BRO ADC AST (EIB) 

States whether or not the IP network is to receive broadcasts. If specified, 
broadcasts are sent onto the network from the device. Default is FALSE. ' 

Responses D? network <ip_network> is defined. 
IP subnet <ip_network> is defined. 

-WARNING- The max_datagram_size must be at least 4 bytes smaller 
than the maximum frame size for the underlying trunk <trunk_name>. 
The specified value of <old_max_datagram_size> bytes was shortened to 
<new_max_datagram_size> bytes to meet this requirement. 

-ERROR- IP network <ip .network > is already defined. 

-ERROR- An IP network/subnet is already defined for X.25 trunk 
< trunk _name > . 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- Trunk name must be specified if hop_count is zero. 

-ERROR- IP address <ip .address > is invalid. 

-ERROR- IP address <ip_address> is not defined. 

-ERROR- IP network <ip .network > is invalid. Only the network 
number part of an IP address should be specified. 

-ERROR- IP address must be specified if hop .count is nonzero. 

-ERROR- Default gateway must be configured with non-zero hop count. 

-ERROR- IP address <ip .address > must be on a directly connected IP 
network. 
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-ERROR- Trunk < trunk _name> is not defined as a network solution. A 
DEFINE _ETHER_NET command is required. 

-ERROR- Trunk < trunk _name> is not defined as a network solution. A 
DEFINE _HDLC_NET command is required. 

-ERROR- The X.25 Interface is not defined for trunk <trunk_name>. A 
DEFINE _X25 ..INTERFACE command is required. 

-ERROR- The max_datagram_size must be at least 4 bytes smaller than 
the maximum frame size for the underlying trunk < trunk _name>. 

-ERROR- An IP network is already defined for X.25 trunk <trunk_ 
name>. 

-ERROR- IP subnet <ip ..network > specified is too large for subnet mask 
size. 

-ERROR- IP subnet <ip_network> is invalid. 

-ERROR- IP subnet <ip ..network > is already defined. 

-ERROR- IP network <ip ..network > subnet mask size is inconsistent 
with the previously defined subnet mask size. 

-ERROR- IP subnet <ip ..network > is not defined. 

-ERROR- The Reverse ARP Server can only be activated on an Ethernet 
. . trunk. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples define. iD.net 1p_network=(1,0,0,0) trunk_name = $net_1 .. 
ip.address = (128,5,0,0) hop.count = .. 
max_datagram_s1ze = 576 

IP Network 1.0.0.0 is defined. 
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DEFINE _IP_X25_PDNJHOST (DEFIXPH) 
DI Configuration Procedure/NETOU Command 



Purpose 



Format 



Parameters 



Configures an IP host address and associated X.25 information when the 
host is located on an X.25 PDN. The command is logically equivalent to 
the DEFINE _IP_HOST command, which is used to configure hosts located 
on Ethernet, HDLC, and X.25 DDN trunks. 

DEFINE _IP_X25 _PDN .HOST 
IP.ADDRESS = list 4 of 0..255 

REMOTE _DTE .ADDRESS = string 1..15 

LOCAL _J)TE_ADDRESS = string 1..15 

HOSTJTYPE = keyword value 

ACCEPT ^PDNjCHARGES = boolean 

FACILITIES = string 2..62 

INACTIVITY JTIMER = inter 1.. 65535 or INFINITE 

IP_ADDRESS (IA) 

Specifies the IP address of the host/workstation/PC to be configured. The 
network number portion of the IP address must have previously been 
defined by a DEFINE _IP_NET command. The format is similar to the 
decimal octet convention used by the TCP/IP community, except that the 
periods are replaced with commas, and the list is enclosed in parentheses. 
For example, the IP address 128.2.53.7 is represented as (128,2,53,7). 

REMOTE _PTE ^ADDRESS (RDA) 

Specifies the remote DTE address associated with the IP address. The 
address is specified as a string of digits through 9. This is the DTE 
address used when creating a virtual circuit to transmit data to the 
associated IP address. This parameter is required if the HOST TYPE is 
IP_HOST. 

LOCAL _PTE_ADDRESS (LDA) 

Specifies the local DTE address. The address is specified as a string of 
digits through 9. This is the calling DTE address used when creating a 
virtual circuit to transmit data to the associated IP address. If the HOST_ 
TYPE is LOCAL, this address is used as the default calling DTE address 
for all hosts on the network. Note that the LOCAL _DTE ADDRESS and 
the REMOTE _DTE .ADDRESS are used by IP in determining when a new 
virtual circuit must be created. If the PDN being used does not 
automatically insert the calling DTE address into an X.25 call request, the 
local DTE address must be specified on the DEFINE _X25 .INTERFACE 
command, or on a DEFINE _IP_X25 .PDN _HOST command where HOST. 
TYPE is LOCAL, or on all DEFINE _IP_X25_PDN .HOST commands 
where the HOSTJTYPE is IP.HOST. 
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CDC_HOST (CH) 



HOSTJTYPE (HT) 

Specifies the type of host associated with the configured IP address. The 
default is IP_HOST. The following types are allowed: 

Keyword Value Description 

LOCAL (L) The specified IP address refers to this DI. This IP 

address is the source address used by IP if the upper 
layer protocols, such as TELNET, do not specify a 
source address. There must be only one IP address of 
type LOCAL configured for each IP network to which 
a DI is physically connected. When HOSTJTYPE is 
LOCAL, the IP^ADDRESS and LOCAL _DTE_ 
ADDRESS are the only parameters that have 
meaning. 

The specified IP address refers to the alternate 
address of this DI. That is, it is another IP address 
for this DI, in addition to the IP address of the 
LOCAL host type. A DI can be configured to have 
several IP addresses. Of these addresses, only one 
address can be of type LOCAL for each connected IP 
network; all other addresses must be of type CDC_ 
HOST. There should be a DEFINE _IP_HOST with 
HOSTJTYPE of CDC_HOST for every CYBER that 
this DI is to access and/or service. When HOSTJTYPE 
is CDC_HOST, the IP_ADDRESS and LOCAL _DTE_ 
ADDRESS are the only parameters that have 
meaning. 

The specified IP address refers to a host that is not 
the local DI. This HOSTJTYPE is used to define 
other IP hosts on the PDN so that an IP address can 
be mapped to a DTE address and vice versa. 

ACCEPT _PDN_CHARGES (APC) 

Specifies how a call initiated from the remote DTE should be handled. If 
TRUE, an incoming call is accepted with either normal or reverse 
charging. If FALSE, incoming calls are accepted only with normal charging. 
The default is FALSE. 

FACILITIES (F) 

Specifies the facilities options as specified by the X.25 CCITT protocol. The 
parameter is a string containing an even number of hexadecimal digits. By 
default, no facilities are supplied in calls initiated to the remote DTE 
address. 

INACTIVITY JTIMER (IT) 

Specifies a timer, in minutes, for measuring inactivity on an X.25 virtual 
circuit. The virtual circuit is inactive when no data is transferred in either 
direction. If the inactivity timer expires, the virtual circuit is cleared. A 
new virtual circuit is established upon demand. The default is 10 minutes. 
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Responses IP host address <ip_address> is defined. 

-ERROR- Facilities may only include digits "0".."9" and "A".."F". 

-ERROR- Facilities must have an even number of hexadecimal digits. 

-ERROR- Hosts on an ETHERNET network must be defined with the 
DEFIH command. 

-ERROR- Hosts on a DDN network must be defined with the DEFIH 
command. 

-ERROR- Host_type of LOCAL is already defined for network 
< network _address > . 

-ERROR- IP address <ip_address> is invalid. 

-ERROR- IP host address <ip_address> is already defined. 

-ERROR- IP network < network _address> is not defined. 

-ERROR- IP subnet < subnet .address > is not defined. 

-ERROR- Local _dte_address may only include digits "0".."9". 

-FATAL- Not enough memory is currently available for required table 
space. 

-ERROR- Remote _dte_address must be specified for host_type IPJHOST. 
-ERROR- Remote _dte_address may only include digits "0".."9". 
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DEFINE _LINE (DEFL) 

DI Configuration Procedure/NETOU Command 

Purpose Defines logical line name, physical hardware address, the TIP name 

servicing the line, physical line attributes, and connect timeout values of a 
terminal communication line or URI parallel interface line. 

Examples at the end of this description show DEFINE _LINE entered two 
ways: in a configuration procedure and through the Network Operator 
Utility (NETOU) while the network is running. 

NOTE 

For lines supported by X.25 Async TIPs, do not use this command to 
define the lines. Instead, use DEFINE _X25_ASYNCTIP, described later in 
this chapter. 

Format DEFINE _LINE 

LIM = 0..7 
PORT = 0..7 
TIP_NAME = name 

LINE^fAME = name 

LINEJTYPE = keyword value 

LINE _SUB JTYPE = name 

CARRIER JTYPE = keyword value 

LINE_$PEED = keyword value 

AUTO ^RECOGNITION = keyword value 

TRANSMISSION _BLOCK_SIZE = 128..4095 

CONNECTION _CONNECT JTIMEOUT = 20..1000 or keyword value 

CONNECTION DISCONNECT JTIMEOUT = 0..1000 or keyword value 

TERMINAL ^DEFINITION _PROCEDURE = name 

TERMINAL _USER_PROCEDURE = name 

START = boolean 

USER JCONNECTION _LIMIT = 1..16 

EIA_FLOW_CONTROL = boolean 

CLOCKING = keyword value 

DATA_PARITY= keyword value 

VALIDATE _USERS = boolean 

Parameters LIM (L) 

Slot number for the Line Interface Module (LIM) or Unit Record Interface 
(URI) board in the MTI/TDI to which the line connects. An MTI or TDI 
allows for up to eight LIMs/URIs. 

PORT (P) 

LIM port number that connects to the line. The ports supported per LIM is 
LIM model-specific. Depending on the LIM model supporting the line, this 
parameter range is through 1, through 3, or through 7. 
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TIP_NAME (TN) 

Name of the TIP servicing the line. See DEFINE _TIP description 
(parameter TIP_NAME or USER_TIP_NAME for user-defined TIPs) for 
allowed TIP names. 

NOTE 

For TIPs supporting X.PC, if TDPs configure the terminal devices (see 
DEFINE ..TERMINAL .DEVICE), the TDP must not contain a DEFTD 
command with a nonzero device address. The X.PC protocol starts only 
when the device address is zero. 

LINE_NAME (LN) 

Logical name of the line or URI parallel interface. The default line name 
is constructed from the SLOT and PORT parameter values, as in $LIM3_ 
PORT1 or $URI2. 

If TD?_NAME is ASYNCTIP, HASP, NJEF, or MODE4, and a user 
connects to a NOS host, the NOS terminal name is based on the line name 
(unless a TDP containing a DEFINE .TERMINAL .DEVICE naming the 
terminal is also specified). Ensure the terminal name for each line is 
unique throughout the network. 

LINEJTYPE (LT) 

Line type, which is either SWITCHED or DEDICATED. Default is 
SWITCHED. For URI-supported lines, the value for this parameter is fixed 
as DEDICATED. 

The TIP servicing a line handles switched and dedicated lines the same, 
except for the defaults for CONNECTION _CONNECT_TIMEOUT (CCT) 
and CONNECTION _DISCONNECT_TIMEOUT (CDT) parameters. For 
dedicated lines, default for CCT and CDT is INFINITE. For switched lines, 
default for CCT and CDT is 120. 
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LINE _SUB JTYPE (LST) 

Subtype of line, which a site can use to further qualify the line type, such 
as WATS or INWATS. The line subtype is reported in all device accounting 
messages generated for the line. 

CARRIER JTYPE (CT) 

Type of carrier control on the line, which is either CONSTANT or 
CONTROLLED. Default is CONSTANT. Ignored if TIP_NAME = URITIP. 

LINE_SPEED (LS) 

Speed of a communication line in bits per second. The following line speeds 
are allowed. 

50 

75 

110 

150 

300 

600 

1200 

1800 

2400 

3600 

4800 

7200 

9600 

19200 

38400 

48000 

56000 

64000 

Default is 1200 (if not requesting auto recognition of speed). 

The following line speed ranges are supported by individual TIPs: 

TIP Line Speed Range 

ASYNC 50 through 38400 



HASP 
NJEF 

NTF 


1200 through 64000 


BSC3270 


50 through 9600. 


MODE4 


1200 through 19200. 



This parameter is only informational either if the LIM board does not 
generate data clocking for the line or if auto recognition of line speed is 
requested for an asynchronous line. 

Ignored if TIP_NAME=URITIP. 
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AUTO RECOGNITION (AR) 

Defines the type of auto recognition to be performed for asynchronous 
lines. Allowed values include the following: 



Keyword Value Description 



NONE No auto recognition. 

S Auto recognition of line speed only. 

SC Auto recognition of line speed and code set. 

SCP Auto recognition of line speed, code set, and parity. 

The only parity types recognized are odd and even. 

SCPNE Auto recognition of line speed, code set, and parity. 

Parity types are none and even. 

Default is NONE. 

If auto recognition of code set and parity is not requested, ASCII code set 
and even parity are assumed. A terminal user can change these values by 
the CHANGE .TERMINAL .ATTRIBUTES command. On a switched line, a 
terminal user has 90 seconds to complete the auto recognition logic. 

This parameter is ignored if TIP_NAME=URITIP. 

TRANSMISSION _BLOCK_SIZE (TBS) 

Defines the transmission block size to be used for transmission blocks 
exchanged with the device(s) on this line. 

This value reserves input buffer space in the CIM. Use the maximum 
block size sent to CDCNET by a HASP, Mode 4, BSC 3270, NJEF, or NTF 
connection. Otherwise, CDCNET may disconnect the line because of 
excessive errors on the line. 

Values range from 128 (80(16)) through 4095 (0FFF(16)). The value may be 
specified in hexadecimal form. Default value is the TBS on the DEFINE. 
TIP command. This parameter applies to the following TIPs: ASYNC, 
HASP, MODE4, NJEF, BSC3270, and NTF. 

CONNECTION JCONNECTJTIMEOUT (CCT) 

Defines the amount of time the line user has to create the first 
$INPUT/$OUTPUT connection. You can either specify an amount of time 
within the range of 20 through 1000 seconds, or use the keyword value 
INFINITE, indicating an infinite period of time. If no connection is 
established within that time, the line is disconnected. It may be necessary 
to increase this value if the VALIDATE .USERS parameter is TRUE. 

The value of this parameter is rounded up to the nearest multiple of 4 
seconds. As a result, there may be a discrepancy between the value 
specified on this command and the value displayed in the response to the 
DISPLAY.LINE .OPTIONS command (entered through NETOU) for this 
line. This timeout value does not include the possible auto recognition 
time. The timer has a precision of +/- 2 seconds. 

The default is 120 seconds for a switched line and INFINITE for a 
dedicated line. 
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CONNECTION JDISCONNECTJTIMEOUT (CDT) 

Defines the amount of time the line user has to establish a new 
$INPUT/$OUTPUT connection after the last such connection has been 
disconnected. If no new connection is established within that time, the line 
is disabled and reenabled, causing a switched line to be disconnected or the 
modem signals of a hardwired line to be dropped for a period of time. You 
can either specify an amount of time within the range of through 1000 
seconds, or use the keyword value INFINITE, indicating an infinite period 
of time. The default is 120 seconds for a switched line and INFINITE for a 
dedicated line. The value of this parameter is rounded up to the nearest 
multiple of 4 seconds. As a result, there may be a discrepancy between the 
value specified on this command and the value displayed in the response to 
the DISPLAY_LINE .OPTIONS command (entered through NETOU) for 
this line. This timeout value does not include the possible auto recognition 
time. 

TERMINAL JDEFINITION JPROCED URE (TDP) 

Name of a terminal definition procedure (TDP) file. The commands within 
the named file are executed when the line becomes active. If both a TUP 
and TDP parameter are specified on a DEFINE _LINE command, the TUP 
parameter is ignored and only the TDP is executed. You can specify a TDP 
on a DEFINE _LINE command if you want to define a terminal device in 
a way that differs from the defaults set by the TIP controlling the lines 
and terminal devices connected to the DI. 

TERMINAL _USER _PROCEDURE (TUP) 

Specifies the name of a terminal user procedure (TUP) file to be executed 
when the DEFINE _LINE command executes. The commands within the 
TUP specified by this parameter are executed for each interactive device 
on the line that becomes active. 

The TUP parameter is ignored if the TERMINAL .DEFINITION. 
PROCEDURE (TDP) parameter is also used to specify a TDP to be 
executed for this line. A TUP is not executed if a TDP parameter is 
specified on a DEFINE _LINE command. If you use the TDP parameter but 
you also want to use a TUP to define terminals on this line, the 
commands in the TDP used for the line must specify any TUPs to be 
executed for the line. 

This parameter is ignored if TIP_NAME=URITIP. 

You can specify a TUP on a DEFINE _LINE command if you want to 
define a terminal's characteristics in a way that differs from the defaults 
set by the TIP controlling the lines and terminal devices connected to the 
DI. The TUP name specified here overrides the value of the TUP 
parameter on the DEFINE _TIP command. 

START (S) 

Specifies whether or not the line should be started after it is configured. 
Possible values are TRUE, start; and FALSE, do not start. Default is 
TRUE. 
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USER ..CONNECTION JJMIT (UCL) 

Defines the maximum number of connections that a user of the line can 
have outstanding at one time. This maximum number of connections may 
range from 1 through 16. Default is 4. This parameter is ignored if TIP_ 
NAME=URITIP. 

For lines supporting the X.PC protocol, user connections are counted in the 
following manner: each virtual circuit without an $INPUT/$OUTPUT 
connection is counted as one connection. All other virtual circuits are 
counted as equal to the number of $INPUT/$OUTPUT connections they 
have. When the user connection limit is reached, no new virtual circuits or 
$INPUT/$OUTPUT connections are permitted. 

EIAJFLOW_CONTROL (EFC) 

Specifies whether or not the Clear to Send and Request to Send flow 
control are used to stop and resume the flow of input and output data. The 
options are ON and OFF. Default is OFF. All synchronous TD?s ignore this 
parameter. The LIM cables must support flow control if this parameter is 
set to ON. 

CLOCKING (C) 

Specifies whether the LIM internally generates the clock signal for data on 
this line or uses an externally generated clock signal. If the LIM generates 
the data clock signal, the clocking rate is derived from the LINE_SPEED 
parameter. This parameter is ignored for URI lines. The following keyword 
values are allowed. 

Keyword Value Description 



EXTERNAL 



INTERNAL 



RECEIVE 



Specifies that the LIM derives data clocking for both 
receive and transmit data from external signals 
(LINE_SPEED is then informational only). 
EXTERNAL receive data clock is derived from the 
RS-232 DD circuit for RS-232 ports or the RS-449 SR 
circuit for RS-449 ports. EXTERNAL transmit data 
clock is derived from the RS-232 DB circuit for 
RS-232 ports or the RS-449 ST circuit for RS-449 
ports. 

Specifies that the LIM generates the required clocking 
signals for both transmit and receive data (with 
NULL modem cable TN109). A single clock signal is 
generated; it matches the line speed specified for the 
line. The LIM supplies the clock on the RS-232 DA or 
RS-449 TT circuit. 

Specifies that the LIM generates the clocking for 
received data, but derives the clocking for transmitted 
data from an external source. The receive data clock 
matches the line speed specified for the line. The LIM 
supplies the receive data clock on the RS-232 DD or 
RS-449 SR circuit. The LIM derives the transmit data 
clock from the RS-232 DB or the RS-449 ST circuit. 
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Keyword Value Description 



TRANSMIT 



Specifies that the LIM generates clocking for transmit 
data but derives clocking for receive data from an 
external source. The transmit data clock matches the 
line speed specified for the line. The LIM supplies the 
transmit data clock on the RS-232 DA or RS-449 TT 
circuit. The LIM derives the receive data clock from 
the RS-232 DD or the RS-449 SR circuit. 



Default is INTERNAL. 

Set Clocking to INTERNAL for asynchronous communication lines. For 
synchronous terminals that provide the transmit clock, set CLOCKING to 
TRANSMIT (with NULL modem cable TNI 09). Most terminals generate 
the transmit clock as defined by the RS-232 standard. When using a 
modem, CLOCKING must be set to EXTERNAL and modem cable TN108 
must be used, since the modem generates both clocking signals. 
Inappropriate selection of INTERNAL clocking causes data to be received 
with errors or not received at all. 

DATA_PARITY (DP) 

Specifies parity for data received and transmitted on a line. The following 
keyword values are allowed. 

Keyword Value Description 

ZERO 

MARK 

EVEN 

ODD 

NONE 



The parity bit is always 0. 

The parity bit is always 1. 

The parity bit is set so that the sum of the parity and 
data bits is even. 

The parity bit is set so that the sum of the parity and 
data bits is odd. 

The parity bit is considered a data bit. This type of 
parity is significant only during transparent input or 
output. When input or output mode is not transparent, 
parity is treated as if it were ZERO. 

Default data parity is EVEN. 

All values are allowed for the ASYNC TIP. This parameter is ignored by 
the URI, BSC3270, HASP, and MODE4 TIPs. 

VALIDATE JUSERS (VU) 

Specifies if users of this line are validated when the validation is enabled 
by the DEFINE _USER .VALIDATION command. If TRUE is specified, 
validation is enabled. Default is the VU value for the TIP associated with 
this line. 
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Responses Line <xxx> definition in progress. 

-ERROR- LIM <xx>, port <yy> addresses a port that cannot be 
serviced. More than 48 ports are attached to CIMxx. Ports beyond the 48th 
port attached to a CIM are not serviced. 

-ERROR— LIM <xx>, port <yy> not defined, hardware status indicates 
port is in a DOWN or OFF state. 

-ERROR- LIM <xx>, port <yy> not defined, LIM and port previously 
defined. 

-ERROR- 3270 TIP will not operate with LIM <xx>. 

-ERROR- Unable to define TIP <TTP name>. No CIM is installed. 

—ERROR- LIM <xx>, port <yy> not responding or not installed. 

-ERROR- TIP <name> is not a CDC defined TIP name. 

-ERROR- TIP <name> not defined. 

-ERROR- TIP type <name> is not supported on the 8-port LIM. 

-ERROR— Line <name> previously defined. 

-ERROR- Line speed <line_speed> is not supported by the specified TIP. 

-ERROR- Load module <TIP name> _CIM is not available. 

-ERROR— An HDLC or X.25 trunk that is already defined is serviced by 
the same CIM as this line. The HDLC driver for the trunk requires the 
CIM to be dedicated to HDLC or X.25 trunks. 

-FATAL- Not enough memory is currently available for required table 
space. 

-FATAL- No CIM RAM space for I/O processor <xx> in board slot 
<xx>. 
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Remarks 



Examples 



Two timers on lines cannot be configured and are assigned fixed values by 
terminal support software. These timers are the delay reenable for 
switched lines and delay reenable for dedicated lines. They control the 
action taken when a line disconnects and the amount of time that elapses 
until the line can be reenabled. For switched lines, the time is 2 seconds 
after the line disconnects. For dedicated lines, this timeout varies according 
to the TIP supporting the line. For ASYNCTIP lines, the time is 5 seconds 
after the line disconnects. For all other TIPs, the delay reenable for 
dedicated lines is 2 minutes. During this time, a line user cannot perform 
auto recognition or connect to CDCNET. 

For a dedicated URI printer line, a power-off condition causes log messages 
to occur (about every 2 minutes). If a printer is powered off for long 
periods of time, you should stop its line with a STOP_LINE command (see 
CDCNET Network Operations manual). 

The following example shows a DEFINE _LINE command as it would be 
entered in a configuration procedure for a TDI or MTI. This example 
defines a synchronous line with a line speed of 9600 bits per second that is 
controlled by the HASP TIP. The equipment connected to the line is 
further defined by the commands in a TDP named STATION2. 

def1ne_line line_name=l1ne11,lim=1.port=1,t1p_name=hasptip, . . 
1 i ne_type=ded1cated, 1 1ne_speed=9600, . . 
terml nal _def 1 n1 1 1on_procedure=stat ion2 

The following example shows a DEFINE _LINE command being entered 
using the Network Operator Utility (NETOU) to define an asynchronous 
line while a network is running. A network operator uses the NETOU 
SEND_COMMAND to send the DEFINE .LINE command to the TDI 
connected to the line. NETOU is invoked by entering the NETWORK _ 
OPERATOR.UTILITY (NETOU) command on NOS/VE and by selecting 
the NETOU application during the login process on NOS. The nou/ in the 
example is a prompt sent by NETOU when NETOU is currently invoked. 
The DEFINE _LINE command itself is sent as a string value within 
SEND_COMMAND. 

Unlike the first example, where the line was defined through a command 
in a configuration procedure, this example shows a temporary configuration 
change. That is, when the TDI resets and its software is reloaded, the line 
defined in this example is not redefined. For the line to be redefined every 
time the TDI's software is reloaded, the DEFINE _LINE command has to 
be placed in the TDI's configuration procedure. 

nou/send_command command='def ine_11ne I1ne_name=l1ne23 f .. 

1 i m=2 , por t =3, t i p_name»asynct i p , 1 1 ne_speed=9600' , system=td1 _84 
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DEFINE _LLC_2_TRUNK (DEFL2T) 

DI Configuration Procedure/NETOU Command 

Purpose Defines LLC 2 parameters and X.25 parameters applicable only when 

running X.25 over Ethernet. When the peer is a CDCNET device, this 
command is normally not needed. As this command (as well as DEFINE _ 
X25 .INTERFACE) is simulated internally in the CDCNET device, the 
defaults described below are automatically used. However, when the peer is 
a non-CDCNET device, this command (as well as DEFINE _X25_ 
INTERFACE) is needed, especially in defining the X.25 virtual circuit call 
establishment method by the mode parameter. 

The LLC 2 trunk is considered as an X.25 trunk by several other 
commands. This includes all of the X25 interface commands (such as 
DEFINE _X25 .INTERFACE) and CANCEL _X25_TRUNK. However, for 
CONS static routing, the ADD_NON_CDC .ROUTING _ENTRY command 
should define a static routing entry based on the ETHER trunk, not the 
LLC 2 trunk. 

This command is required to configure any X.25 user other than CONS to 
run on top of X.25 over Ethernet. An X.25 user on top of an LLC 2 trunk 
is the same an X.25 user on top of an X.25 trunk except that the LLC 2 
trunk does not support PVCs. 

NOTE 

You must configure CONS, even if CONS is not a user of the trunk, 
whenever you use DEFL2T to manage the LLC 2 services associated with 
the trunk. 

Format DEFINE _LLC .2 .TRUNK 

ETHER .TRUNK NAME = name 
PEER .MAC .ADDRESS = string(12) 
PEER_£SAP_M>DRESS = 1..255 
TRUNKJVAME = name 
MODE = keyword value 
RECEIVE _WINDOW_SIZE = 1..127 
TRANSMIT _WIND0WJSIZE = 1..127 
ACKNOWLEDGEMENT JTIMER = 500..65535 
POLL _flIT JTIMER = 500..65535 
REJECTJTIMER = 500..65535 
BUSYJSTATE JTIMER = 500..65535 

Parameters ETHER .TRUNK .NAME (ETN) 

Specifies the logical name of the Ethernet trunk to be used for the LLC 2 
trunk. The Ethernet trunk with this name must be configured prior to the 
execution of this command. 

PEER .MAC .ADDRESS (PMA) 

Specifies the MAC address of the peer system. 

PEER _LSAP ^ADDRESS (PLA) 

Specifies the LSAP address associated with the X.25 packet-level entity of 
the peer system. The most common values used are 7E(16) and FE(16). 
The default is FE(16), that is 254 (10). 
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TRUNK _NAME (TN) 

Specifies the logical name of the LLC 2 trunk. The default name is 
constructed from the 12- digit peer MAC address as follows: $X25_LLC_2_ 
<peer MAC address >. 

MODE (M) 

Specifies the mode of operation of the X.25 trunk. Allowed keyword values 
include the following: 

Keyword Value Description 



DCE The DI operates as the Data Communication 

Equipment end for the X.25 trunk. 

DTE The DI operates as the Data Terminating 

Equipment end for the X.25 trunk. 

RESTART The DI initially operates as a DTE, but may 

switch to DCE-base on X.25 RESTART packet 
negotiation. 

DYNAMIC The DI operates as a DTE but uses the X.25 

Reference Number Facility to dynamically assign 
logical channels during virtual circuit 
establishment. 

The default mode is DYNAMIC. 

RECEIVE _WINDOW_SIZE (RWS) 

Specifies the maximum number of LLC 2 I-frames the peer LLC 2 entity 
can send without receiving an acknowledgement. The default is 16. 

TRANSMIT _WINDOWJSIZE (TWS) 

Specifies the maximum number of LLC 2 I-frames the local LLC 2 entity 
can send without receiving an acknowledgement. The default is 16. 

ACKNOWLEDGEMENT JTIMER (AT) 

Specifies the value of the timer, in milliseconds. The LLC 2 timer defines 
the time interval during which the local LLC 2 entity expects to receive 
either an acknowledgement to one or more I-frames or a response PDU to 
a sent unnumbered command PDU. The default is 3000. 

POLL _RIT JTIMER (PBT) 

Specifies the value of the timer, in milliseconds. The LLC 2 timer defines 
the time interval during which the local LLC 2 entity expects to receive a 
PDU with the final bit set in a response to a sent LLC 2 command PDU 
with the poll bit set. The default is 3000. 

REJECT JTIMER (RT) 

Specifies the value of the timer, in milliseconds. The LLC 2 timer defines 
the time interval during which the local LLC 2 entity expects a response 
to a sent Reject (REJ) PDU. The default is 5000. 
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BUSYJSTATEJTIMER (BST) 

Specifies the value of the timer, in milliseconds. The LLC 2 timer defines 
the time interval during which the local LLC 2 entity waits for an 
indication of the clearance of a busy condition from the peer LLC 2 entity. 
The default is 10000. 

Remarks • This command is useful whenever you want to use some capability of a 
non-CDCNET device that communicates to a PDN over X.25. For 
example, when you want to use a router that has a higher HDLC speed 
over X.25 than over a CDCNET DI. This command allows CDCNET to 
talk to the router. 

• This command is needed to support the X.500 server application on an 
EP/IX system when it is providing services out a CDCNET X.25 trunk. 

Responses LLC 2 trunk < trunk _name> defined for trunk < ether _trunk_name>. 

-ERROR- Trunk < ether _trunk_name> is not defined. 

-ERROR- Trunk < ether _trunk_name> is not an ETHERNET trunk. 

-ERROR- Trunk name < trunk _name> already defined. 

-ERROR- Peer MAC address <peer_mac_address> already defined for 
trunk < ether _trunk_name>. 

-ERROR- Peer MAC address <peer_mac_address> contains 
non-hexadecimal characters. 

-FATAL- Not enough memory is currently available for required table 
space. 
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DEFINE _NAME_RESOLVER (DEFNR) 

DI Configuration Procedure/NETOU Command 



Purpose 



Format 



Parameters 



Defines and starts the DI Domain Name Resolver (DNR). Also, it verifies 
that User Data Protocol (UDP) has been configured in the Gateway Device 
Interface (GDI). If UDP has been configured, the DNR is successfully 
initialized and requests can be accepted and queries sent out to Domain 
Name Servers (DNS). 

DEFINE _NAME _RESOLVER 

DOMAIN .NAME = string 1..255 

SERVER .ADDRESSES = list 1..4, 4 of integer 0..255 

RETRY JLIMIT = integer 0.256 
RETRY JTIMER = integer 1..32 

DOMAIN .NAME (DN) 

Defines the name of the local administrative domain for the DNR. When 
requested to obtain information about a name and the name is a simple 
domain label, the DNR appends the DOMAIN _NAME parameter to the 
label before querying a DNS. The string consists of a series of domain 
labels separated by periods (for example, arh.cdc.com). A domain label in 
the string can be up to 63 characters long. 

SERVER .ADDRESSES (SA) 

Defines the order in which to query the IP addresses of the DNSs. The IP 
addresses are used in the order in which they are entered to communicate 
with the DNSs. At least one address is required which becomes the 
primary DNS. Up to three additional addresses may be entered specifying 
the secondary DNS. 

RETRY_LIMIT (RL) 

Defines the maximum number of times a query is reissued over UDP. 
Default is 4. 

RETRYJTIMER (RT) 

Defines the timeout value used for UDP datagrams. It is used to reissue a 
UDP datagram if no response is received within the RETRYJTIMER 
period. Also, it is the value used to timeout a request if the application 
has not specified a timeout value. Default is 10 seconds. 
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Responses The TCP/IP Name Resolver is defined. 

-ERROR- The TCP/IP Name Resolver is already defined. 

-ERROR- Domain _name cannot contain the character < character >. 
Domain _name can only contain the characters A-Z, a-z, 0-9, hyphen (-) and 
underscore (_). 

—ERROR- A domain _name label is too long. Each label cannot be greater 
than 63 characters. 

-ERROR- UDP is not defined. 

Examples def 1ne_name_reso1ver doma1n_name = 'arh.cdc.com' .. 
server .address = ((129,179,60,48) .. (GRAY) 
(129,179,52,203) .. (ROYAL) 
(129,179.48,30)) .. (ODEON) 
retry_11m1t = 5 . . 
retry_timer = 10 

The TCP/IP Name Resolver Is defined. 
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DEFINE _NP_GW (DEFNG) (NOS Only) 

DI Configuration Procedure/NETOU Command 

Purpose This command and the ADD_NP__GW_OUTCALL (ADDNGO) command 
define the CDCNET titles by which this NOS Network Products 
application-to-application (A-to-A) gateway is to be known throughout 
CDCNET. 

Three types of titles are associated with this gateway. 

• The first type of title (defined by the ADDNGO command) supports 
access to a specific application on NOS via the NP gateway from 
NOS/VE applications or from another NP gateway. 

• The second type of title supports access to the gateway by using the 
coupler node number. Control Data does not recommend using this title 
format. The format of this second title type is $GW_NP_jcx, where xx 
is the ASCII representation of a two-digit hexadecimal number, which 
is specified by the NOS_DHOST_NUMBER parameter. Only the xx 
portion of the title is site- definable; the $GW^NP_ portion is internally 
supplied by CDCNET. Calling NOS applications must have their 
respective OUTCALL blocks constructed with a DHOST field set to the 
xx value registered as part of the title of the called NOS gateway. See 
the OUTCALL command in the NAM Network Definition Language 
manual. 

• The third type of title supports access in the same way as the second 
type, except the title is completely site- definable and conforms to the 
CDNA definition of a title. This type is currently not used. 

Refer also to the ADD_NP_GW_OUTCALL command description in this 
manual. 

Format DEFINE _NP_GW 

GATEWAyZjXAME = name 

TRUNK_NAME = name 

NOS .PROTOCOL _JD = list 1..7 of 2.. 255 

CDCNET JPROTOCOLJD = list 1..7 of 2.255 

NOS _J>HOST_NUMBER = list 1..15 of 0.. 255 

TITLE = list 1..15 of name 

DEFAULT JTRANSLATION _DOMAIN = name 

DEFAULT JSEARCH _J>OMAIN = name 

START = boolean 

Parameters GATEWAY^fAME (GN) 

Logical name of the gateway used in subsequent commands that reference 
the gateway. Default is TRUNK _NAME. 

TRUNK ^NAME (TN) 

Specifies the trunk name of the NOS host/MDI logical link that is to be 
used to support A-to-A traffic with this host. Default is the trunk specified 
on the DEFINE .SYSTEM command. Default on that command is the 
channel over which the MDI/MTI was loaded. 
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NOS .PROTOCOL JD (NPI) 

Specifies one or more protocol IDs that identify outcalls to be routed to 
NOS systems by host node number. Defaults are C0(16) and Cl(16). 

CDCNET_PROTOCOLJD (CPI) 

Specifies one or more protocol IDs to identify outcalls that are to be routed 
to NOS/VE systems or other gateways by application title. Default is 
C2(16). 

NOS _J)HOST_JN UMBER (NDN) 

Specifies 1 through 15 destination host (DHOST) numbers for the host 
supported by this gateway. Each NDN consists of two hexadecimal digits. 
The digits are used to construct the second type of title for calls to this 
NOS host from other NOS hosts. NOS applications access this NOS host by 
constructing OUTCALL blocks with a DHOST field value equal to the 
digits defined by this parameter. The actual titles registered in the 
directory are in the format $GW_NP_jcx, where the xx portion consists of 
the ASCII equivalent of the hexadecimal digits. A default title is 
constructed from the coupler node number received from the host when the 
gateway's connection to the host is opened. That is, the default title is 
$GW_NP_cn, where en is the ASCII equivalent of the coupler node value. 

TITLE or TITLES (T) 

Specifies the third type of title or titles by which this gateway can be 
accessed. This title is used to support calls to the connected NOS host that 
originate in a system other than another NOS host. No default. 

DEFAULT JTRANSLATION _DOMAIN (DTD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the catenet to which the services of this gateway are to be 
made available. Default is CATENET. 

DEFAULT _SEARCH JDOMAIN (DSD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the catenet that should be searched in order to find the 
service that corresponds to the title information received by the gateway in 
ICN/AP/R messages. Default is CATENET. 

START (S) 

Specifies whether or not the NP gateway should be started after it is 
configured. Default is TRUE; started. Currently, the START parameter is 
ignored. Its value is always TRUE, even if FALSE is specified on the 
command. 
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Responses NP gateway <name> is defined. 

NP gateway <name> is defined and started. 

--WARNING-- NP gateway <name> is defined for trunk <name>. NP 
interface for the trunk is started but the logical link is down. 

-WARNING- NP gateway <name> is defined for trunk <name>. NP 
interface for the trunk is not started. Start NP interface to enable NP 
gateway. 

-ERROR- NP gateway <name> is already defined. 

-ERROR- NP gateway is already defined for trunk <name>. 

-ERROR- NP interface is not defined for trunk <name>. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-ERROR- Protocol ID < protocol _id> already assigned. 

-FATAL- NP gateway cannot be defined. Unable to initialize the NP 
gateway function. 

-FATAL- NP gateway cannot be defined. 

Not enough memory is currently available for required table space. 

Examples def ine_np_gw nos_dhost_number=0A1(16) 
NP gateway trunk_name is defined. 
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DEFINE _NP_INTERFACE (DEFNI) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the network block protocol interface program (BIP) to a NOS host. 
BIP is a software component that helps CDCNET applications and 
gateways connect to Network Access Method (NAM) in a NOS host. 

This command is needed only in NOS MDIs with more than one MCI, or 
when you choose to have an MDI loaded over an Ethernet network 
solution. 

An "unable to start" error message indicates that the interface was defined 
but not started. The COUPLER _NODE and MDI_NODE parameters need 
to be specified in a system configuration procedure only if the host is 
installed with a version of software (before NOS version 2.5.2) that does 
not support the coupler node verification feature, and the MDI is not going 
to be loaded over the channel. A DEFINE _NP_JNTERFACE command 
specifying the COUPLER _NODE and MDI_NODE parameters should not 
be used in any other case. 

Format DEFINE JSTP.INTERFACE 

TRUNK _NAME = name 

MDIJVODE = 0..255 
COUPLER Jf ODE = 0.255 
INTERFACE _NAME = name 
CONGESTED JTHRESHOLD = 20.255 
START = boolean 

Parameters TRUNK _NAME (TN) 

Name of the channel trunk to be used for this interface. The channel 
trunk with this name must be configured before executing this command. 

MDIJVODE (MN) 

MDI node identifier of the logical link. If specified, MN must be set equal 
to the NT parameter on the NOS host's EST definition for this logical link 
and to the DNODE parameter on OUTCALL statements for putcalls to be 
carried over this logical link. No default. 

COUPLER _NODE (CN) 

Coupler node identifier of the logical link. If specified, this parameter must 
be set equal to the ND parameter on the NOS host's EST definition for 
this logical link. Default is the coupler node number obtained from the 
host. 

INTERFACE _NAME (IN) 

Logical name of the NP interface. Default is the trunk name. 

CONGESTED JTHRESHOLD (CT) 

Specifies the number of messages in BIP's outgoing queue at which the 
network products interface is considered congested. Default is 30 messages. 
The point at which the NP interface is again considered uncongested is 75 
percent of the congested threshold. 
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START (S) 

Specifies whether or not the NP interface should be started. Default is 
TRUE; started. 

Responses NP interface < interface _name> is defined. 

NP interface < interface _name> is defined and started. 

-WARNING- NP interface < interface _name> command processor has 
timed out waiting for a response from the NP interface. 

-ERROR- Trunk <trunk_name> is not defined. 

-ERROR- Trunk < trunk _name> is not a Channel trunk. 

-ERROR- NP interface name < interface _name> is already defined. 

-ERROR- NP interface < interface _name> is already defined for trunk 
< trunk _name > . 

-ERROR- Trunk <name> already assigned. 

-ERROR- Coupler node < integer > already assigned. 

—FATAL- NP interface cannot be defined. Not enough memory is currently 
available for required table space. 

-FATAL- Unable to start NP interface < interface _name>. Unable to 
start task SVM.- • 

-FATAL- Unable to start NP interface < interface _name>. Unable to 
start task BIP. 

-FATAL- Unable to start NP interface < interface _name>. Unable to 
send ITM to NP interface task. 

-FATAL- Unable to start NP interface < interface _name>. Memory 
management SAP table not found. 

-FATAL- Unable to start NP interface < interface _name>. Unknown 
status returned from open memory SAP. 

Examples def 1ne_np_1nterface trunk_name=$mc13 
NP Interface $mc13 1s defined. 
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DEFINE _NPJTERMINAL_GW (DEFNTG) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the CDCNET titles by which the host connected to this MDI is to 
be known when the host is being accessed for a terminal-to-application 
(T-to-A) interactive connection or a terminal-to-Remote Batch Facility 
(T-to-RBF) connection. These titles are specified as 1- to 31-character 
logical identifiers of the NOS host. 

This command also defines the trunk between a NOS host and the MDI to 
be used to support T-to-A interactive and T-to-RBF batch traffic. 

Format DEFINE _NP_TERMINAL _GW 

TITLE = list 1..15 of name(s) 
GATEWAY JNAME = name 
TRUNK_NAME = name 
TRANSLATION JOOMAIN = name 
DEFAULT JTERMINAL JCLASS = 1..8 or 18 

TERMINAL _MODEL_MAPPING = list 1..32 of (string 1.25, integer 
1..18) 

BATCH JTITLE = name 

DEFAULT JBATCH JTERMINAL JCLASS = keyword value 
START = boolean 

Parameters TITLE or TITLES (T) 

Specifies the titles by which the host associated with this MDI is to be 
known by interactive terminal users accessing CDCNET. 

GATEWAY JtAME (GN) 

Logical name of the gateway used in subsequent commands that reference 
the gateway. Default is TRUNK _NAME. 

TRUNK JNAME (TN) 

Specifies the trunk name of the NOS host/MDI logical link which is to be 
used to support the interactive T-to-A traffic or batch T-to-RBF traffic with 
this host. Default is the trunk specified on the DEFINE .SYSTEM 
command. Default on that command is the channel over which the 
MDI/MTI was loaded. If the MDI/MTI was not loaded over a channel, and 
no default channel trunk is specified on the DEFINE _SYSTEM command, 
then no default channel trunk exists. 

TRANSLATION JOOMAIN (TD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the catenet to which the services of this gateway are to be 
made available. Default is CATENET. 
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DEFAULT _TERMINAL_CLASS (DTC) 

Specifies the terminal class to be supplied by the gateway in the terminal 
connection request (ICN/TE/R) message sent to NAM. This value is used 
when the terminal class cannot be determined from the terminal model 
mapping pairs. (See the TERMINAL .MODEL .MAPPING parameter 
description described next.) Default is 3. 

TERMINAL _MODEL_MAPPING (TMM) 

Specifies a list of pairings between terminal models (string 1..25) and 
Network Products terminal classes (1..18). The gateway references the list, 
using the terminal model, to find out which terminal class to use in a 
terminal connection request (ICN/TE/R) message sent to NAM. A default 
terminal model mapping table is provided by the NP terminal gateway, 
shown in the following table. 

If a terminal model in the default mapping table is redefined by a 
DEFNTG command, the DEFNTG defined pairing replaces the pairing from 
the default table. A DEFNTG definition of a new terminal model adds the 
new pairing to the terminal model mapping table maintained by the NP 
terminal gateway. 

If no terminal model is specified by a user or if a specified terminal model 
is not found in the following table, the default terminal class is used. (See 
DEFAULTJTERMINAL .CLASS parameter). 
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Terminal Model 


Class 


Manufacturer 


cdc_721 


3 


CDC 


cdc721 


3 


CDC 


cdc_722 


2 


CDC 


cdc722 


2 


CDC 


cdc722_30 


7 


CDC 


cdc_722_30 


7 


CDC 


cdc_200UT 


10 


CDC 


cdc_714_30 


11 


CDC 


cdc_711 


12 


CDC 


cdc_714 


13 


CDC 


cdc_734 


15 


CDC 


dec_vtl00 

dec_vtlOO_gold 

dec_vt220 

ibm_hasp_post 

ibm _hasp _pre 

ibm_3270 


7 

7 

7 

9 

14 

18 


Digital Equipment Corp. 
Digital Equipment Corp. 
Digital Equipment Corp. 
IBM (HASP postprint) 
IBM (HASP preprint) 
IBM model 2 


ibm_3270_2 


18 


IBM model 2 (24 x 80) 


ibm_3270_3 


18 


IBM model 3 (32 x 80) 


ibm_3270_4 


18 


IBM model 4 (43 x 80) 


ibm_3270_5 


18 


IBM model 5 (27 x 132) 


mac _connect _10 


7 


Macintosh/Connect 1.0 


mac _connect _1 1 


7 


Macintosh/Connect 1.1 


mac _connect _20 


7 


Macintosh/Connect 2.0 


mode4 


15 


CDC 


mode4C30 


11 


CDC 


pc_connect_10 


7 


IBM PC/Connect 1.0 


pc_connect_ll 


7 


IBM PC/Connect 1.1 


pc_connect_12 


7 


' IBM PC/Connect 1.2 


pc_connect_13 


7 


IBM PC/Connect 1.3 


sun_160 
tek_4109 


7 
8 


Sun Microsystems 
Tektronix 


tek_4115 


8 


Tektronix 


tek_4125 


8 


Tektronix 


vtlOO 
zl9 


7 

7 


Digital Equipment Corp. 
Zenith 


z29 


7 


Zenith 


zen_zl9 


7 


Zenith 


zen_z29 


7 


Zenith 



BATCH JTITLE (BT) 

Specifies the title by which the host associated with this MDI is to be 
known by Remote Batch Facility (RBF) users accessing the host through 
CDCNET and/or the name of the control facility for stand alone printers 
connected to NOS. This title must be unique. If omitted, batch access is 
not supported by this gateway definition. 

DEFAULT _BATCHJTERMINAL_CLASS (DBTC) 

Specifies the default terminal class for batch devices. Allowed terminal 
classes and batch device types associated with each class are as follows: 
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Class Terminal Model Batch Device Type 



9 


ibm_hasp_post 


IBM HASP postprint 


10 


cdc_200ut 


CDC 200UT Mode 4A 


11 


cdc_714_30 or mode4c30 


CDC 714-30 Mode 4C 


12 


cdc_711 


CDC 711-10 Mode 4C 


13 


cdc_714 


CDC 714-10/20 Mode 4C 


14 


ibm_hasp_pre 


IBM HASP preprint 


15 


cdc_734 or mode4 


CDC 731/734 Mode4A 


18 


ibm_3270 


IBM 3270 


Default is 


9. 





START (S) 

Specifies whether or not the NP terminal gateway should be started. 
Default is TRUE; started. Currently, the START parameter is ignored. Its 
value is always TRUE, even if FALSE is specified on the command. 

Responses NP terminal gateway <name> is defined. 

NP terminal gateway <name> is defined and started. 

-WARNING- NP terminal gateway <name> is defined for trunk 
<name>. NP interface for the trunk is started but the logical link is 
down. 

-WARNING- NP terminal gateway <name> is defined for trunk 
<name>. NP interface for the trunk is not started. Start NP interface to 
enable NP terminal gateway. 

-ERROR- NP terminal gateway <name> is already defined. 

-ERROR- NP terminal gateway is already defined for trunk <name>. 

-ERROR- NP interface is not defined for trunk <name>. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-ERROR- Batch title <name> is the same as an interactive title 
specified for this gateway. The batch title must be unique. 

-ERROR- Improper Terminal Model Mapping element <xx> specified. 
The first element in the set must be STRING (31) or NAME, the second 
element must be an INTEGER value of 1 to 18. 

-ERROR- Invalid DBTC parameter value <xx> was specified. 

-ERROR- Invalid DTC parameter value <xx> was specified. 

-FATAL- NP terminal gateway cannot be defined. Unable to initialize the 
NP terminal gateway function. 

-FATAL- NP terminal gateway cannot be defined. 

Not enough memory is currently available for required table space. 

Examples def 1ne_np_term1nal_gw t1tle=ARHSES batch_t1tle=RBFBATCH 
NP terminal gateway ARHSES is defined. 
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DEFINE _OPERATOR_SUPPORT (DEFOS) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Defines and starts the Operator Support Application in this MDI or MTI to 
allow network operators to communicate with the network DIs through this 
MDI or MTI, using the Network Operator Utility (NETOU). NETOU must 
be configured and running on the NOS host to which the MDI is 
connected. 

The operator support for each unique trunk name operates independently. 
That is, the operator support for multiple trunk names operates as if the 
trunk names were defined on separate MDI/MTI systems. Commands 
addressed to the Operator Support Application function for one trunk do 
not affect the Operator Support Application function for other trunks. 

Format DEFINE ^OPERATOR SUPPORT 

TRUNK^NAME = name 

Parameters TRUNK JSTAME (TN) 

The trunk name of the logical link that is to be used for the operator 
support connection. Default is the trunk specified on the DEFINE _ 
SYSTEM command. Default on that command is the channel over which 
the MDI/MTI was loaded. If the MDI/MTI was not loaded over a channel, 
and no default channel trunk was specified on the DEFINE _SYSTEM 
command, then no default channel trunk exists. 

Responses Operator Support is defined for trunk <name>. 

-WARNING- Operator Support is defined for trunk <name>. NP 
Interface for the trunk is started but the logical link is down. 

-WARNING- Operator Support is defined for trunk <name>. NP 
interface for the trunk is not started. Start NP interface to enable 
Operator Support. 

-ERROR- NP Interface is not defined for trunk <name>. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-ERROR- Operator Support for trunk <name> is already defined. 

-FATAL- Operator Support cannot be defined for trunk <name>. Not 
enough memory is currently available for required table space. 

-FATAL- Operator Support cannot be defined for trunk <name>. Unable 
to initialize the Operator Support function. 

Remarks This command is required only in the configuration files of NOS MDIs or 
MTIs that are selected by the site to support an operator interface to the 
channel- connected NOS host. It should not be placed in the configuration 
procedures of MDIs connected to NOS/VE hosts. The connected NOS host 
must be configured to run NETOU. 

Examples define_operator .support 

Operator Support Is defined for trunk $mc12. 
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DEFINE .OUTCALL _GATE WAY (DEFOG) 
DI Configuration/NETOU Command 

Purpose Configures the Outcall Gateway. The Outcall Gateway must be installed 
into every DI having devices configured as outcall servers. See the 
CDCNET Terminal Interface manual for detailed information. 

Format DEFINE .OUTCALL .GATEWAY 

REGISTRATION JTITLE = list 1.2 of name 

DEFAULT INACTIVITY JTIMER = 120..14400 or INFINITE 

START = boolean 

Parameters REGISTRATION JTITLE (RT) 

Specifies one or two additional titles that may be used for server 
registration. To become a server, a device must connect to the Outcall 
Gateway and register itself as a server. The address to which to make this 
connection is obtained by completing a title translation to the $OUTCALL 
title or to one of the titles specified by this parameter. 

The title $OUTCALL is always registered even if this parameter is not 
specified. 

DEFAULT INACTIVITY JTIMER (DIT) 

Specifies the maximum time, in seconds, that an outcall connection can 
remain idle (no data has been transferred in either direction on the 
connection). This value establishes a default timer for all server devices. A 
continuous period of inactivity that exceeds this value results in 
termination of the connection, making the server available to a subsequent 
client. 

The default value, INFINITE, specifies that outcall connections are not to 
be timed out. The default can be overridden for individual servers by using 
the INACTIVTTYJTIMER parameter of the DEFINE .SERVER _DE VICE 
command (see the Terminal Interface manual). 

START (S) 

Specifies whether or not the defined service is to be started. Default is 
YES. 

Responses Outcall Gateway is defined. 

Outcall Gateway is defined and started. 

-ERROR- Outcall Gateway is already defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_outcal l_gateway d1t=l20 s=no 
Outcall Gateway Is defined. 
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DEFINE _PASSTHROUGH .SERVICE (DEFPS) 
DI Configuration Procedure/NETOU Command 

Purpose Installs the Interactive Passthrough Gateway (IPG) application and 

optionally selects a passthrough connection timeout value. This command 
should be present in the configuration files of all DIs that have 
passthrough ports connected to them. 

NOTE 

In future releases, this command will no longer be supported. You should 
start using the DEFINE _OUTC ALL .GATE WAY command as soon as 
possible. 

Format DEFINE .PASSTHROUGH .SERVICE 

TITLE = name 

INACTIVITY JTIMER = 120..14400 or INFINITE 

START = boolean 

Parameters TITLE (T) 

The title of the passthrough service. Passthrough ports are connected to 
the passthrough service using a CREATE .CONNECTION command with a 
SERVICE .NAME parameter equal to the value of this parameter. Default 
is PASSTHROUGH. 

INACTIVITY JTIMER (IT) 

The maximum time in seconds that a passthrough connection can remain 
idle. Idle means that no data has been transferred in either direction on 
the connection. When this timer value is exceeded, the passthrough 
connection to the terminal user is disconnected. Default is INFINITE; 
passthrough connections are not to be timed out. 

START (S) 

Specifies whether or not the defined service is to be started. Default is 
YES. 

Responses Passthrough Service < title > defined. 

Passthrough Service < title > defined and started. 

-WARNING- Passthrough Service < title > defined but not started. 

-ERROR- Passthrough Service previously defined. 

-FATAL- Not enough memory is currently available for required table 
space. 
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Remarks 



Examples 



See also the DEFINE .PASSTHROUGH .TITLES command in the CDCNET 
Terminal Interface Usage manual. 

You can set the INACTIVITY_TIMER at this level instead of at the 
gateway level. 

This example shows a passthrough service being defined and started. The 
title of the passthrough service in this example is different from the 
default title. 

def1ne_passthrough_service tit1e=termpass 

Passthrough service termpass defined. 
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DEFINE .PRINTER .MODEL .ATTRIBUTES (DEFPMA) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the printer attributes for a specific printer terminal model. The 

printer terminal model defined with this command can be referenced on a 
DEFINE _BATCH_DEVICE command to specify the batch device is a 
particular printer model, having that model's attributes. DEFPMA can be 
specified in a DI configuration procedure or via NETOU. 

Format DEFINE .PRINTER .MODEL .ATTRIBUTES 

TERMINAL .MODEL = name 

AUTO.PAGE JEJECTJCHANNEL = 2..12 



list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 
list 1..7 of <ccode> 



CHANNEL .1 .SEQUENCE 

CHANNEL .2 .SEQUENCE 

CHANNEL .3 .SEQUENCE 

CHANNEL .4 .SEQUENCE 

CHANNEL .5 .SEQUENCE 

CHANNEL .6 .SEQUENCE 

CHANNEL .7 .SEQUENCE 

CHANNEL .8 .SEQUENCE 

CHANNEL .9 .SEQUENCE 

CHANNEL .10 .SEQUENCE = list 1..7 of <ccode> 

CHANNEL .11 .SEQUENCE = list 1..7 of <ccode> 

CHANNEL .12. SEQUENCE = list 1..7 of <ccode> 

FORM .FEED .DELAY = 0..3000 

FOLD.LINE = boolean 

FORM .FEED .SEQUENCE = list 1..7 of <ccode> 

KEYBOARD - boolean 

NO^PACE .SEQUENCE = list 1..7 of <ccode> 

SINGLE ^PACE JOELAY = 0..1000 

SINGLE ^PACE .SEQUENCE = list 1. 

BOTTOM .OF JFORM .CHANNEL = 2. 

VFU.TOP.FORM = boolean 

MAXIMUM _VFU JLENGTH = 0..255 

INITIALIZATION .PROCEDURE = name 

INITIALIZATION .SEQUENCE = list 1..31 of <ccode> 

EIGHT _LPI .SEQUENCE = list 1..7 of <ccode> 

FILE PREFIX .PROCEDURE = name 

FILE JPREFIX .SEQUENCE = list 1..31 of <ccode> 

FILE .SUFFIX .SEQUENCE = list 1..31 of <ccode> 

SIX JaPI .SEQUENCE = list 1..7 of <ccode> 



.7 of <ccode> 
.12 



NOTE 



• For character code (ccode) values, see the CDCNET Configuration 
Guide. 

• If you cannot specify all desired parameter values on one DEFINE _ 
PMNTER_MODEL_ATTRIBUTES command, use one or more 
CHANGE_PRINTER_MODEL_ATTRIBUTES commands to specify 
additional attributes. 
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Parameters TERMINAL _MODEL (TM) 

Name of the printer terminal model (1 through 25 characters long) for 
which attributes are being defined. 

If the name begins with "POSTSCRIPT.", CDCNET does the following 
special processing: 

• Substitutes the file page width for NOS/VE or device page width for 
NOS for any occurrence of the following string in the device's file 
prefix procedure: 

$PW 

• Substitutes the device forms size, as determined by the DEFINE _ 
BATCH .DEVICE FORMS _SIZE parameter for NOS/VE and the PSU 
PRSIZE parameter for NOS, for any occurrence of the following string 
in the device's file prefix procedure: 

$FS 

• Inserts the "V* character in front of each of the following characters 
when encountered in nontransparent output file data: 

\ 

( 
) 

This parameter must not be the same as any other terminal model already 
defined by Control Data or by your site. 

AUTO^PAGE _£JECT_CHANNEL (APEC) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Channel 
causing the printer to skip automatically to the next top-of-form channel. 
May not be the same as the BOTTOM _OF_FORM .CHANNEL (BOFC) 
value. Default is 2. 

CHANNEL _1_SEQUENCE (CIS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "8" or "H" format effector is recognized in 
output lines. No default. 

CHANNEL _2 _SEQ UENCE (C2S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "7" or "G" format effector is recognized in 
output lines. No default. 

CHANNEL _3_SEQUENCE (C3S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "6" or "F" format effector is recognized in 
output lines. No default. 

CHANNEL _4_SEQUENCE (C4S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "5" or "E" format effector is recognized in 
output lines. No default. 
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CHANNEL _5_SEQUENCE (CSS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "4" or "D" format effector is recognized in 
output lines. No default. 

CHANNEL _6_SEQUENCE (C6S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "3" or "C" format effector is recognized in 
output lines. No default. 

CHANNEL J7J5EQUENCE (C7S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "9" or "I" format effector is recognized in 
output lines. No default. 

CHANNEL _8J5EQUENCE (C8S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "X" or "J" format effector is recognized in 
output lines. No default. 

CHANNEL _9_$EQUENCE (C9S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "Y" or "K" format effector is recognized in 
output lines. No default. 

CHANNEL _10 .SEQUENCE (C10S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "Z" or "L" format effector is recognized in 
output lines. No default. 

CHANNEL _11_SEQUENCE (CHS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "W" or "M M format effector is recognized in 
output lines. No default. 

CHANNEL _12_SEQUENCE (C12S) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "U" or M N" format effector is recognized in 
output lines. No default. 

FORM^EED_PELAY (FFD) 

Supported by ASYNC and X.25 asynchronous TIPs only. Milliseconds 
(maximum 3000) the TIP must delay after sending a CHANNEL __x_ 
SEQUENCE value to the printer. Default is 1000 milliseconds. The TIP 
sends null characters to the device to effect the delay. 

FOLDMNE (FL) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Whether or 
not the TIP must fold lines longer than the device page width. Default is 
YES. 
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FORM _FEED ^SEQUENCE (FFS) 

Supported by ASYNC and X.25 asynchronous TIPs only, sequence of octets 
sent to the printer when a "1" or "A" format effector is recognized in 
output lines. Default is (0D(16),0C(16)) or (CR.FF). 

KEYBOARD (K) 

Supported by ASYNC and X.25 asynchronous TIPs only. Whether or not 
the printer has an associated keyboard. Default is NO. 

If an asynchronous printer is configured with a keyboard, then you can use 
the keyboard to enter the following commands to control the printer: 
DROP, START,and STOP. See the CDCNET Batch Device User's Guide for 
more information onthese commands. 

NO_SPACE _SEQUENCE (NSS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "+" format effector isrecognized in output lines. 
Default is 0D(16) (CR). 

SINGLE _SPACE JOELAY (SSD) 

Supported by ASYNC and X.25 asynchronous TIPs only. 
Milliseconds(maximum 1000) the TIP must delay after sending a SINGLE. 
SPACE .SEQUENCE to theprinter. Default is 50. The TIP sends null 
characters to the device to effect the delay. 

SINGLE J3PACE _SEQ UENCE (SSS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when one of the following format effectors is recognized 
in output lines: 

Format Effector Times Single Space Sequence Sent 

" " (blank; single One 

space) 

"0" (double space) Two 

"-" (triple space) Three 

Default is (0D(16),0A(16)) or (CR, LF). 

BOTTOM _OF_FORM_CHANNEL (BOFC) 

Supported by ASYNC, HASP, and URI TIPs only. Channel to which the 
printer skips when a "2" or "B" format effector is recognized in output 
lines. May not be the same as the AUTO_PAGE_EJECT_CHANNEL 
(APEC) value. Default is 6. 

VFU JTOP_FQRM (VTF) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Whether or 
not the printer must be at top-of-form when the vertical format unit (VFU) 
load image is loaded. Default is YES. 
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MAXIMUM _VFU JLENGTH (MVL) 

Supported by ASYNC, X.25 asynchronous, and URI TIPs only. Maximum 
lines in a VFU load image the printer supports. Default is 127 lines. 

For a printer that supports VFU loading (that is, if the VFU_LOAD_ 
OPTION parameter on DEFINE _BATCH .DEVICE is any value other than 
NONE), it is important that the MVL value does not exceed the maximum 
VFU length the printer actually supports. If the MVL value exceeds the 
actual supported length, attempts to load a VFU load image into the 
printer could fail. No files are sent to the printer until the problem is 
corrected. 

INITIALIZATION PROCEDURE (IP) 

Name of the load procedure containing data output to the printer when the 
line activates. No default. Supported for any TIP handling transparent 
data. 

INITIALIZATION .SEQUENCE (IS) 

Sequence of octets sent to the printer when the line activates. If an 
initialization procedure is specified, the initialization sequence is sent after 
procedure data. No default. Supported for any TIP handling transparent 
data. 

EIGHT JuPI J3EQUENCE (ELS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when a "T" format effector is recognized in output 
lines. No default. This parameter is allowed only if the DEFINE _BATCH_ 
DEVICE VFU_LOAD_OPTION parameter value is NONE. 

FILE PREFIX PROCEDURE (FPP) 

Name of the load procedure containing data output to the printer before 
each nontransparent file. No default. Supported for any TIP handling 
transparent data. 



NOTE 



If you change an FPP, do the following to guarantee that all printers and 
printer terminal models using the FPP get a copy of the changed FPP: 

For each printer terminal model that uses the FPP, send a CHANGE _ 
PRINTER _MODEL .ATTRIBUTES command to the DI or DIs supporting 
the printers. Specify the TERMINAL _MODEL and FILE .PREFIX _ 
PROCEDURE parameters. For more information, see the CDCNET 
Configuration Guide. 

FILE _PREFIX J3EQUENCE (FPS) 

Sequence of octets sent to the printer before each nontransparent file. If a 
file prefix procedure is specified, the file prefix sequence is sent after 
procedure data. No default. Supported for any TIP handling transparent 
data. 

FILE _SUFFIX .SEQUENCE (FSS) 

Sequence of octets sent to the printer after each nontransparent file. No 

default. Supported for any TIP handling transparent data. 
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SIXJLPI_SEQUENCE (SLS) 

Supported by ASYNC and X.25 asynchronous TIPs only. Sequence of octets 
sent to the printer when an "S" format effector is recognized in output 
lines. No default. This parameter is allowed only if the DEFINE _BATCH_ 
DEVICE VFU_LOAD_OPTION parameter value is NONE. 

Responses Printer model <name> defined. 

-ERROR- Printer model <name> is already defined. 

-ERROR- The bottom of form and auto page eject channels cannot be the 
same. 

-ERROR- If EIGHT_LPI .SEQUENCE or SIX _LPI .SEQUENCE is 
specified, then both must be specified. 

Remarks Use DEFINE .PRINTER .MODEL .ATTRIBUTES to specify printer 

attributes for a non-Control Data printer, or to create a new terminal 
model with different default printer attributes than the Control 
Data-supplied attributes. 

NOTE 



When defining new printer models, the terminal model name must be 
unique. Do not use any of the predefined, Control Data-supplied terminal 
model names, such as CDC.585V or CDC.CYBER18. 



Use DEFINE_PRINTER_MODEL_ATTRIBUTES only for DIs connected to 
batch devices that use the terminal model defined by the command. 

When defining a printer model for an asynchronous printer, you may have 
to define a file suffix sequence of (CF.LF) (using parameter FILE. 
SUFFIX_SEQUENCE = (CR,LF)), since some asynchronous printers require 
such codes to flush the printer buffer. 

If an EIGHT.LPI .SEQUENCE or a SDX.LPI .SEQUENCE is defined for 
a printer terminal model, both must be specified. These sequences can only 
be used for batch devices having a DEFINE .BATCH .DEVICE VFU. 
LOAD.OPTION parameter value of NONE. 
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Examples The following example redefines a Control Data 585 printer to have an 
auto page eject channel of 11 (the default auto page- eject channel for the 
Control Data 585 printer is 8). 

def1ne_prlnter_model_attr1butes term1nal_model=user_585 .. 
auto_page_eject_channel*11 vfu_top_form=yes .. 
bottom_of _f orm_channel ■ 12 

The next example defines a URI printer model with a VFU. The printer 
has an auto page eject channel of 2, and a bottom- of-form channel of 12. 
The printer does not do line folding. It supports a maximum VFU size of 
255 lines. 

def1ne_pr Inter _model .attributes term1nal_model=non_585b .. 
bot t om_of _f orm_channe 1*12 maxl mum_ vf u_ 1 engt h=255 

The next example defines an asynchronous printer without a VFU. It uses 
nonstandard preferences to control paper movement and initialize the 
printer. 

def 1ne_pr1nter_model_attr1butes . . 
terminal _model=mypr Inter .. 
f 1 1e_pref1x_sequence=(ESC,'R',CR) . . 
s1 ng 1 e_space_sequence=LF . . 
form_feed_sequence=ESC,'F' .. 
f 1 1e_suf f 1 x_sequence=EOT 
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DEFINE ..RECORDER _LOG .GROUP (DEFRLG) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the log recorder function in a NOS MDI or MTI. Specifies the 

name of the log group that this MDI or MTI supports, and the priority for 
the log recording support. This command is required only in the system 
configuration files of MDIs or MTIs that you select to support a logging 
interface to the Control Data host, using the Independent Log ME. The 
host must be configured to run the Network Log Server application 
NETLS. 

The recorder log groups for each unique trunk name operate independently. 
That is, the recorder log groups for multiple trunk names operate as if the 
trunk names were defined on separate MDI/MTI systems. Commands 
addressed to the Independent Log ME function for one trunk do not affect 
the Independent Log ME function for other trunks. Currently, only one 
recorder log group can be configured per channel trunk for each MDI/MTI 
system. 

Format DEFINE .RECORDER _LOG GROUP 

LOGjGROUP = name 
PRIORITY = 1..0FF(16) 
TRUNK_J!AME = name 

Parameters LOGjGROUP (LG) 

Name of the log group for which this log recorder is to record log 
messages. Default is CATENET (all the DIs in the catenet). A DI can 
belong to only one log group. 

PRIORITY (P) 

Priority at which the log group is to be supported. The default, which is 
also the highest priority, is 1. 

TRUNK_NAME (TN) 

The trunk name of the logical link which is to be used for the connection 
to the Network Log Server application on the NOS host. Default is the 
trunk specified on the DEFINE .SYSTEM command. Default on that 
command is the channel over which the MDI/MTI was loaded. If the 
MDI/MTI was not loaded over a channel, and no default channel trunk was 
specified on the DEFINE .SYSTEM command, then no default channel 
trunk exists. 
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Responses Recorder log group is defined for trunk <name>. 

-WARNING- Recorder log group is defined for trunk <name>. NP 
interface for the trunk is started but the logical link is down. 

-WARNING- Recorder log group is defined for trunk <name>. NP 
interface for the trunk is not started. Start NP interface to enable log 
recording. 

-ERROR- NP interface is not defined for trunk <name>. 

-ERROR- No default channel trunk is defined. A trunk name must be 
specified. 

-ERROR- A recorder log group is already defined for trunk <name>. 

-FATAL- Recorder log groups cannot be defined for trunk <name>. Not 
enough memory is currently available for required table space. 

-FATAL- Recorder log groups cannot be defined for trunk <name>. 
Unable to initialize the log recording function. 

Examples Two MDIs in a network are to be configured with the logging recorder 
function. MDI_l's logging recorder has the highest priority (1). MDI_2's 
logging recorder has a priority of 2. If MDI_1 becomes unavailable, 
transmission of all log messages is switched to MDI_2. The following 
commands would be used in the configuration procedures for MDI_1 and 
. MDI_2 to configure them with the logging recorder function. 

MDI_l's configuration procedure: 

def 1 ne_recor der_l og_group pr i or 1 ty= 1 
MDI_2's configuration procedure: 

defme_recorder_log_group pr1ority=2 
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DEFINE .REMOTE _LINE .MONITOR (DEFRLM) 
DI Configuration/NETOU Command 

Purpose Defines the title, forward-timer, LIM number, and port number of the 
Remote Line Monitor. 

If the connection is broken, the Remote Line Monitor must be redefined. 

Format DEFINE _REMOTE _LINE .MONITOR 

LINE_INTERFACE MODULE = 0..7 
PORT = 0..7 
TITLE = name 

FORWARDJTIMER = 200..30000 

Parameters LINE .INTERFACE .MODULE (LIM) 
Defines the LIM number to be monitored. 

PORT (P) 

Defines the port number of the selected LIM to be monitored. 
TITLE (T) 

Defines the title that the Remote Line Monitor registers. 
FORWARD_TIMER (FT) 

Defines the timer to be used to forward monitor data in milliseconds 
Default is 2000. 

Responses Remote Line Monitor defined, $LIM <lim>_PORT <port>. 

Remote Line Monitor previously defined, $LIM <lim>_PORT <port>. 

LIM <lim> and/or PORT <port> not available. 

No line or trunk defined for $LIM <lim>_PORT <port>. 

Unable to open Session Layer SAP. 

Unable to register title, < title >. 
Examples def ine_remote_line_mon1tor 11m=3 p=1 t=11ne1 

Remote Line Monitor defined, $LIM5_PORT0 . 
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DEFINE ^REMOTE __LO AD .SUPPORT (DEFRLS) 
DI Configuration Procedure/NETOU Command 

Purpose Defines and starts the remote load support network management service 

(Independent Initialization Management Entity) in a DI. When remote load 
support is defined in a DI, it can load other DIs over a network to which 
both DIs are directly connected. 

If you have a network with several network solutions, you must establish a 
minimum number of DIs that provide remote load support, so that even 
DIs not directly connected to a NOS/VE or NOS host can be loaded. With 
remote load support, DIs can be loaded over a network solution to which 
they are directly connected. 

NOTE 

Do not use this command for an ICA-II. 

This command is not required in DIs that are loaded over a NOS/VE or 
NOS host channel. For those DIs, remote load support is provided by 
default. This command is required to configure remote load support in DIs 
not directly connected to a NOS/VE or NOS host. For an example of 
remote load support, see the CDCNET Configuration Guide. 

Format DEFINE ..REMOTE JLO AD SUPPORT 

PRIORITY = 0..3 

CONCURRENT _LO AD _LIMIT = 0..8 

RESTRICTED _NETWORK = list 1..15 of name 

Parameters PRIORITY (P) 

Specifies the priority of the "help offer" that a DI containing remote load 
support sends to remote systems when they request to be loaded. Default, 
which is also the highest priority, is 3. 

The DI to be loaded uses the help offer's priority to decide if it should 
accept the help offer. The DI to be loaded accepts a help offer right away 
if its priority is 3. However, if the priority of the help offer is less than 3, 
the DI to be loaded waits for a certain period before it accepts a help 
offer. During this period, if the DI to be loaded receives a help offer at 
priority 3, it accepts that help offer. Otherwise, at the end of this period, 
it selects the highest priority help offer among all help offers received 
during this period. 

You can use this parameter to assign backup remote load support to a DI. 
For example, you can assign one DI to provide primary remote load 
support by using the default for this parameter. You can assign backup 
remote load support to another DI by defining remote load support and 
assigning it a lower priority, such as 2. If the first DI cannot respond to 
load requests, the second DI does. 
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CONCURRENT JLOADJJMIT (CLL) 

Specifies the maximum number of DIs which may be simultaneously loaded 
by the DI providing remote load support. Default is 4. 

You can use this parameter to prevent a DI from loading more DIs than 
the limit you set. When the number of DIs being concurrently loaded 
equals the limit set, the DI does not respond to load requests from other 
DIs. 

RESTRICTED _NETWORK (RN) 

Specifies the names of networks over which a DI containing remote load 
support should not load other DIs. When this parameter is specified, the 
remote load support in a DI does not respond to load requests from DIs 
that are on the restricted network or networks. Default is an empty list; 
by default, a DI containing remote load support loads remote DIs over all 
directly connected network solutions. 

Responses Remote Load Support is defined. 

-ERROR— Remote Load Support is already defined. 

-ERROR- Command 'define _remote_load_support' is invalid for an ICA. 

-FATAL- Remote Load Support can not be defined at this time. Not 
enough memory is currently available for required table space. 

Examples def ine_remote_load_support pr1ority=1 .. 
restricted_networlc=hdlc_net 

Remote Load Support is defined. 
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DEFINE_SERVER_DEVICE (DEFSD) 



Purpose Defines both passthrough and device outcall servers. This command can be 

only executed after making a connection to the Outcall Gateway. 

Format DEFINE_SERVER_DEVICE 

TTTLE=name or keyword 

ALLOWEDJLCCESS=keyword 

INACTIVnY_TIMER=120..144O0 or INFINITE 

CONTROL_SERVERJ>ORT=boolean 

MODEM_PROTOCOL=name 

PASSTHROUGH_RESPONSE=boolean 

Parameters TITLE (T) 

Specifies the logical name of the server that must be used by clients when 
attempting to make connections to the server. Default is USER_ID. 

When a name value is used and the server is site-configured, the value 
specified for this parameter is the title registered. 

When a name value is used and a server is user-configured for passthrough 
access, the title registered is the value specified for this parameter with the 
prefix T_ (for example, T_name). 

When a name value is used and the server is user-configured for device 
outcall access, the title registered is the value specified for this parameter 
with the prefix D_ (for example, D_name). 

When a name value is used and a server is user-configured for both types of 
accesses, two titles are registered, one with each prefix. 

When the key value USER_ID is specified, and the server port is configured 
for network validation, the title is constructed from the server's validated 
USER.NAME and DOMAIN NAME. The title registered is in the form 
USER_NAME@DOMAIN_NAME. 

When USER_ID is specified and the server port is not configured for 
network validation, the DEVICE_NAME associated with the server port is 
used as the title unless the DEVICE.NAME begins with a $ and the 
LINE_NAME does not. In this case, the LINE_NAME, rather than the 
DEVICE_NAME is used as the title. 

ALLOWEDJlCCESS (AAJ 

Specifies how the server can be accessed. The keyword value DEVICE. 
OUTCALL permits access from host applications. The keyword value 
PASSTHROUGH permits access from terminal users. The default keyword 
value ALL permits access to both, providing that the passthrough service 
has been purchased; if not, ALL is equivalent to the value 
DEVICE_OUTCALL. 

INACTIVITYjnMER (IT) 

Specifies the maximum time, in seconds, that a client connection can remain 
idle. Allowed values are any integer from 120 through 14400, or the 
keyword INFINITE. Clients who do not transmit or receive data for this 
time period are disconnected from the server, and the server is made 
available to other clients. If you specify INFINITE, the network does not 
disconnect the connection because of inactivity. 

The default value is determined by the DEFAULT_INACTIVITY_TIMER 
parameter of the DEFINE_OUTCALL_GATEWAY command. 
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CONTR0LJSERVERJ>ORT (CSP) 

Selects whether or not the control signals of the server port are disconnected 
when a client is not accessing the server. The default for user-configured 
servers is FALSE, and the default for site-configured servers is TRUE. 

MODEM_PROTOCOL (MP) 

Used only when the server device is a modem with dialout capability. This 
parameter specifies the command-level protocol implemented by the modem. 
Currently, the only supported keyword value is the keyword HAYES. This 
parameter has no default value. 

When MODEM_PROTOCOL=HAYES, the outcall gateway requires that the 
client provide dialing information in the SERVICE_DATA parameter of the 
CREATE_CONNECTION command. The outcall gateway performs the 
dialing protocol with the modem and includes the dialed telephone number 
in the log messages that record server usage. You (the client) are limited to 
one call per connection and are not allowed to escape into command mode 
with the modem. 

When the server device is a dialout modem and the MODEM_PROTOCOL 
parameter is not specified, you must perform the dialing protocol from your 
terminal. The outcall gateway discards any SERVICE_DATA that it 
receives, and does not record the dialed telephone numbers in the server 
usage logs. 

PASSTHROUGHJtESPONSE (PR) 

Specifies whether the server should pass input data immediately or wait for 
a <Carriage Return> or <Line Feed>. If TRUE, the server passes input data 
immediately, if FALSE, the server waits for a <Carriage Return> or <Line 
Feed> before passing input data. The default is FALSE. 

NOTE 

If configuring a postscript printer or other device that returns data, the 
PASSTHROUGH_RESPONSE parameter should be set to TRUE. If 
configuring an ASCII printer that does not return any data, the 
PASSTHROUGHJRESPONSE parameter can be left as the default of 
FALSE. 

Examples Following is an example command sequence for configuring a passthrough 

server: 

create_connection $outcall 
define_server_device allowed_access=passthrough 

Since the TITLE parameter was not specified in this example, the default 
USER_ID is used, and the title registered depends on whether or not 
network validation is configured for this line. If it is, the title is constructed 
from the server's user name and domain name in the form 
USER_NAME@DOMAIN_NAME. If network validation is not configured, 
the title is the server's DEVICE_NAME, unless the DEVICE_NAME begins 
with a $. If it does, the server's LINE_NAME becomes the registered title. 

NOTE 

If the first input you send to the outcall gateway after the CREATE. 
CONNECTION command is not a DEFINE_SERVER_DEVICE command, 
you are prompted with the following message: 

Input discarded. 

Please enter DEFINE_SERVER_DEVICE command. 
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Responses If the DEFINE .SERVER _DE VICE command is successful, the following 
response appears: 

Server Device defined. 

This response indicates that the user has become a registered passthrough 
server and, therefore, is a candidate to receive connections from 
passthrough clients. 

When a passthrough client makes a connection to the server, the server 
receives the following message: 

Passthrough client connection complete. 
System ■ system_name. Line = I1ne_name. 

If the client subsequently disconnects from the server, the server receives 
the following message: 

Client disconnected 

If the site administrator stops the outcall gateway, the server and client 
receive the following message and their connections with the outcall 
gateway terminate: 

Outcall Gateway stopped 

The error responses to the DEFINE _SERVER .DEVICE command are: 

Passthrough service is not available. 

This indicates that the passthrough service feature has not been purchased 
(or installed). 

Modem protocol Is not supported. 

This message indicates that the value specified for the MODEM _ 
PROTOCOL parameter is not HAYES. 

If input is sent by the server when no client is connected, the server 
receives the following message: 

Input discarded 
Waiting for Client 
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DEFINE .SERVER _TELNET_GW (DEFSTG) 
DI Configuration Proeedure/NETOU Command 



Purpose 



Configures a server TELNET gateway, which provides access to the 
interactive terminal services of a CYBER host to remote terminal users on 
hosts connected via a TCP/IP network. 

If both terminal (via TELNET) and application (via FTP) services are to be 
provided for the same IP address, the application gateway (TCP/IP 
gateway) or the TCP/IP access interface must be defined in the same DI as 
the server TELNET gateway. It is not possible for more than one DI to 
service the same IP address. 

The timeout parameters, TCPJTIMEOUT for TCP and INACTIVITY. 
TIMEOUT for TELNET, impose no limits on the user. That is, a user can 
leave a connection idle for any period of time without losing the 
connection. 

NOTE 



The host service may impose inactivity limits. 



Format DEFINE .SERVER .TELNET GW 

GATEWAY.NAME = name 
IP_ADDRESS = list 4 of 0..255 

TITLE = name 

TRANSLATION _DOMAIN = name 

MAX ^CONNECTIONS = 0..65535 or INFINITE 

TCP JPORT_Jf UMBER = 0..65535 

TCP_ALLOCATE _$IZE = 0..7FFFFFFF(16) 

TCPJTIMEOUT = 0..65535 or INFINITE 

START = boolean 

Parameters GATEWAY_NAME (GN) 

The logical name of the server TELNET gateway used in subsequent 
commands that reference the gateway. 

IP.ADDRESS (IA) 

The IP address of the host for which this gateway provides server 
TELNET terminal service. The format is similar to the decimal octet 
convention used by TCP/IP, except the periods are replaced with commas, 
and the list is enclosed in parentheses. For example, the IP address 
128.2.53.7 is represented as (128,2,53,7). 

TITLE (T) 

Specifies the title that this gateway translates to locate the service 
provider. If the destination system is NOS, this title must be from the 
TITLE parameter of the DEFINE _NPJTERMINAL_GW command. If the 
destination system is NOS/VE, this title must be the one registered by the 
terminal manager. Default is supplied from the GATEWAY_NAME 
parameter. 
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TRANSLATION _POMAIN (TD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the CDCNET catenet that should be searched for the service 
corresponding to the title information given in the TITLE parameter. 
Default is CATENET. 

MAX JCONNECTIONS (MC) 

Specifies the maximum number of simultaneous connections to be supported 
by the gateway. If INFINITE is entered, there is no restriction to the 
number of connections allowed. Default is INFINITE. 

TCP_PORT_NUMBER (TPN) 

Specifies the TCP port number to be used by the gateway. Default is the 
well-known server TELNET port 23. Server TELNET issues a TCP passive 
connect request using the well-known port for the source port. 

TCP ^ALLOCATE _SIZE (TAS) 

Specifies the amount of data that the gateway queues for each connection. 
Larger values might improve user response time, especially for PC users 
(with a standard protocol such as XMODEM) but can increase the number 
of instances of DI congestion. Default is 4096 bytes. 

CAUTION 

Changing this value is discouraged because network service might be 
disrupted. 

TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgement of data transmission. If an acknowledgement is not 
received within the specified period, TCP aborts the connection. A small 
TCP timeout value (less than a few seconds) might cause frequent and 
unnecessary loss of service during periods of network congestion. A large 
TCP timeout value might leave users waiting a long period of time after a 
host or network has failed. If INFINITE is entered, the connection does not 
time out. Default is 300 seconds. 

START (S) 

Specifies that the newly configured gateway is to be started after it is 
defined. Default is TRUE. 
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Responses Server TELNET gateway < gateway _name> is defined and started. 

Server TELNET gateway < gateway _name> is defined. 

-ERROR- Server TELNET gateway < gateway _name> is already defined. 

-ERROR- IP Address <ip .address > is not defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_server_telnet_gw gateway.name = gw_to_cyber .. 
1p_address = (128,5,0,2) title = ve106 

Server TELNET gateway GW_TO_CYBER Is defined and started. 
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DEFINE _SERVICE (DEFS) 

INETD Configuration File Command 

Purpose Creates an entry in the INETD_CONFIGURATION file for a service that 
Internet Daemon (INETD) controls. 

This command is valid only in file $SYSTEM.TCP_IP.INETD_ 
CONFIGURATION. Do not use this command in a DI configuration 
procedure. 

Format DEFINE .SERVICE 

SERVICE = name 

ALIASES = list of names 
APPLICATION _NAME = name 
DEBUG_MODE = boolean 
DEBUG JAODE JNTERACTIVE = boolean 
INITIAL J3TATE = keyword value 
MANTA_FILE_NAME = file 
PARAMETER _STRING = string 
PORT = integer 
PROTOCOL = keyword value 
QUEUE JJMIT = integer 1..15 
SERVICE _TASK = file 
STARTING .PROCEDURE = name 
USERJFLAGJ = boolean 
USER_FLAGJ2 = boolean 
USER_FLAG_3 = boolean 
WAIT = boolean 

Parameters SERVICE (S) 
Service name. 

ALIASES (A) 

List of aliases which may be used to access the service. 

APPLICATION _NAME (AN) 

Application name as it is known to IPAM and NAM/VE; used by NAM/VE 
for connections. 

DEBUG JiiODE (DM) 

If TRUE, defines debug mode of the service task options passed to the 
task. Default is FALSE. 

DEBUG _MODE JNTERACTIVE (DMI) 

Causes the system task to be initiated under the NOS/VE system debugger. 
Default is FALSE. 

INITIAL J3TATE (IS) 

Specifies if the server is initialized as an active or inactive service. 
Keyword values are ACTIVE and INACTIVE. Default is INACTIVE. 

MANTA_FILE _NAME (MFN) 

Name of the file used for communication between MANTA and the server. 
File is created by the service during initialization. 
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PARAMETER _STRING (PS) 

Character string of data that can be passed to the server task by INETD. 
For more information about passing data to the REXEC server task, see 
the default job class information in the NOS/VE Network Management 
manual. For more information about passing data to the SMTP, TFTP, and 
LPD server tasks, see the TCP/IP Internet Daemon (INETD) information in 
the CDCNET Configuration manual. 

PORT (P) 

Well-known port number at which INETD listens for incoming connection 
requests or UDP packets. 

PROTOCOL (P) 

Specifies the protocol to be used for the service. Allowed keyword values 
are TCP and UDP. Default is UDP. 

QUEUE JJMIT (QL) 

Valid only with TCP protocol. Specifies the queue limit on the call to 
IPAM. Default is 5. For further information, see the CDCNET TCP/IP 
Programming Interfaces and Applications manual. 

SERVICE _TASK (ST) 

Service binary file which is executed as a system task. 

STARTING ..PROCEDURE (SP) 

Name of the procedure within the server to which control is passed after 
load completion. 

USER_FLAG_1 (UF1) 

These flags can be set in the service task options which are passed to the 
server task. The purpose of these flags is server-independent. Default for 
all three is FALSE. 

USER_FLAG_2 (UF2) 
See USER_FLAG_1. 

USER_FLAG_3 (UF3) 
See USER_FLAG_1. 

WAIT (W) 

Valid only for UDP ports. Set to TRUE if the service is defined as 
single-threaded and handles all datagrams arriving on the port. Set to 
FALSE if the service is defined to be multi-threaded, which frees the port 
for further use. 
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Examples "INETD configuration file entry for the FTP server." 

Def1ne_service .. 
service=f tp . . 

app 1 1 cat 1 on_name=OSA$FTP_SERVER . . 
debug_mode=of f . . 
debug_mode_i nteract 1 ve=of f . . 
in1tia1_state=act1ve .. 
port=21 .. 
protocol =TCP .. 

ser vi ce_t ask=$SYSTEM . TCP_IP . FTP_BOUND_PRODUCT . . 
start ing_procedure=IPP$FTP_SERVER_TASK . . 
manta_file_name=$SYSTEM.TCP_IP.FTP_MANTA_SERVICE_FILE 

"INETD configuration file entry for the SMTP server." 

Def1ne_ service .. 
service=smtp .. 

app 1 i cat i on_name=OSA$SMTP_SERVER . . 
debug_mode=of f . . 
debug_mode_interactive=off .. 
1nitial_state=act1ve .. 
parameter_str1ng='MDU=MVE' .. 
port =25 . . 
protocol =TCP .. 

service_task=$SYSTEM.TCP_IP.SMTP_BOUND_PRODUCT . . 
start ing_procedure=IPP$CREATE_SMTP_RECV_CONNECTION . . 
manta_f 1 le_name=$SYSTEM.TCP_IP .SMTP_MANTA_SERVICE_FILE 
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DEFINE _SLIP_GW (DEFSG) 

DI Configuration Procedure/NETOU Command 



Purpose 



Format 



Parameters 



Configures a Serial Line Internet Protocol (SLIP) gateway. The SLIP 
gateway interfaces to the IP router in the DI. This provides the 
workstation with access to all IP networks known to the DI. 

If the IP address does not specify an existing IP network in this DI, a new 
network is created. You must issue a DEFINE _IP_HOST command to 
define the local IP address for the new network. 

To access the SLIP gateway, issue a CREATE .CONNECTION terminal 
user command. See the CDCNET Terminal Interface manual for more 
information. 

DEFINE _SLIP GW 

GATEWAY.NAME = name 
IP_NETWORK = list 1..4 of 0..255 

MAX JDATAGRAM JSIZE = 20..1500 

SUBNET _MASK_SIZE = 10..30 

TITLE = list 1..15 of name 

MAX _SLIP_HOSTS = 1.200 

INACTIVITY JTIMEOUT = 0..65535 or INFINITE 

LOCAL _J,INES_ONLY = boolean 

START = boolean 

GATEWAY_NAME (GN) 

Specifies the logical name of the network SLIP gateway used by 
subsequent commands that reference the gateway. This parameter is 
required. 

IP_NETWORK (IN) 

Specifies the network/subnet number assigned to the SLIP gateway in the 
DI which may or may not specify an existing network. If a new 
network/subnet is specified, the network is defined. If an existing 
network/subnet is specified, connected SLIP host addresses are available to 
other systems via ARP requests. This parameter is required. 

MAX JDATAGRAM _SIZE (MDS) 

Specifies the maximum datagram size in bytes that the SLIP network can 
handle without fragmentation. If the IP_NETWORK parameter specifies an 
existing network, this parameter is ignored. The default is 1500 bytes. 

SUBNET _MASK_SIZE (SMS) 

Specifies whether the SLIP network is to be subnetted. The value 
represents the number of bits in the subnet mask. For subnetting to occur 
the subnet mask must be at least 10, 18, or 26 for Class A, B, or C 
networks, respectively. The subnet mask size must be the same for all 
subnets of a given IP network. If the IP network has been defined to be 
subnetted (with a previously issued DEFINE _IP_NET or DEFINE _SLD?_ 
GW command) and this parameter is omitted, the previously defined subnet 
mask size is used. Otherwise, the IP network defined is not subnetted. 
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Responses 



Examples 



TITLE (TITLES) (T) 

Specifies the title(s) by which this gateway service can be accessed. For 
example, this is the name the CDCNET terminal users supply in the 
CREATE .CONNECTION command. The default is the value supplied for 
the GATEWAY_NAME parameter. 

MAXJSLIPJHOSTS (MSH) 

Specifies the maximum number of simultaneous SLIP connections to be 
supported by the gateway. The default is 100. 

INACTIVITY JTIMEOUT (IT) 

Specifies the interval, in seconds, a connection can be idle before the 
network connection is terminated. The default is INFINITE. 

LOCAL JLINES JONLY (LLO) 

Specifies whether the CREATE .CONNECTION must come from a line 
connected to the DI (that is, the SLIP gateway and the line using it are in 
the same DI). The default is FALSE. 

START (S) 

Specifies whether the newly configured gateway is to be started after it is 
defined. The default is TRUE. 

SLIP gateway < gateway _name> is defined and started for <new OR 
existing > < network OR subnet > < network _address>. 

SLIP gateway < gateway _name> is defined for <new OR existing > 
< network OR subnet > < network _address>. 

-ERROR— SLIP gateway < gateway _name> is already defined. 

-ERROR— IP subnet <ip .network > specified is too large for subnet mask 
size. 

-ERROR— IP subnet <ip .network > is invalid. 

—ERROR— IP network <ip .network > is not directly connected. 

-ERROR— IP network <ip .network > subnet mask size is inconsistent 
with the previously defined subnet mask size. 

-ERROR- SLIP gateway title < title > is already defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

def1ne_s1ip_gw gateway_name=s11p_gw lp_network=(129, 179,71) .. 
subnet _mask_s1 ze=24 



SLIP gateway SLIP_GW 1d defined and started for a new subnet 
129.179.071.000. 

def1ne_s!1p_gw gateway_name=sl_gw_2 ip_network=( 129, 179,72,1) .. 
subnet_mask_s1ze*24 start =false 

SLIP gateway SL_GW_2 1s defined for an existing subnet 129.179.072.000. 
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def1ne_sl1p_gw gateway_name=sl1p_gw ip_network=(129, 179,71, 1) 
subnet _mask_s 1 ze=24 

—ERROR— SLIP gateway SLIP.GW Is already defined. 
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DEFINE _SLIP_HOST (DEFSH) 

DI Configuration Procedure/NETOU Command 

Purpose Adds an entry to the specified SLIP gateway which relates the specified 

host name to an IP address or range of IP addresses. If the host count is 
greater than 1, the IP addresses assigned are the consecutive values 
starting with the specified IP_ADDRESS parameter. Use the CREATE. 
CONNECTION terminal user command to access the SLIP gateway. See 
the CDCNET Terminal Interface manual for more information. Include a 
SLIP host name as the SERVICE _D ATA parameter to assign the 
workstation the corresponding IP address for the SLIP connection. 

Format DEFINE _SLIP_HOST 

HOST.NAME = name 
GATEWAY.NAME = name 
IP_ADDRESS = list 1..4 of 0..255 

HOSTjCOUNT = 1..100 
HOSTJVAMEJ3TRING = string 0.255 

Parameters HOST_NAME (HN) 

Specifies the logical name to be assigned to this entry. This parameter is 
required. 

GATEWAY JNIAME (GN) 

Specifies the logical name of the SLIP gateway for which this entry is 
used. This parameter is required. 

IP_ADDRESS (IA) 

Specifies the IP host address to be assigned to the user side of the SLIP 
network. The network and subnet portions of the IP address must be the 
same as the IP address from the corresponding DEFINE _SLIP__GW 
command. This parameter is required. 

HOSTJCOUNT (HC) 

Specifies the number of hosts for this entry. IP addresses are assigned in 
consecutive order starting with the specified IP_ADDRESS value. The 
default is 1. 

HOSTJSTAME JSTRING (HNS) 

Specifies the string to be included in the text returned to the workstation 
when a SLIP connection is set up. This occurs after a CREATE _ 
CONNECTION is made to the SLIP gateway from a workstation. The first 
character of the string is treated as a format effector to allow control of 
the vertical spacing for the string. In the default value shown below, host_ 
adr is the IP address assigned to the SLIP host and the gw_adr is the 
local IP address of the SLIP network in the DI 

Attaching <host_name» (<host_adr>) to domain CDCNET via •gatewayjiame* (<gw_adr>) 

NOTE 

This message preceded by SUNSLIP is required to cause SLIP in PC/NFS 
dial-up mode to become active. 
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Responses SLIP host <host_name> added to gateway < gateway _name>. 

--ERROR- SLIP host <host_name> is already defined for SLIP gateway 
< gateway _name > . 

-ERROR- SLIP gateway < gateway _name> is not defined. 

-ERROR- IP address <ip_address> is invalid. 

-ERROR- IP address <ip_address> is already defined. 

-ERROR- SLIP host address <ip_address> does not correspond to the 
network address <ip_address> for SLIP gateway < gateway _name>. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_sl ip_host gateway_name=slip_gw host_name=host_2 .. 
1p_address=(129,179,71,2) 

SLIP host HOST_2 added to gateway SLIP_GW. 

define_slip_host gateway_name=s1ip_gw host_name=host_3 .. 
ip_address=(129,179,71,3) host_count=10 

SLIP host H0ST_3 added to gateway SLIP_GW. 

define_slip_host gateway_name=sl ip_gw host_name=host_2 .. 
ip_address=( 129, 179,71,2) 

—ERROR— SLIP host H0ST_2 1s already defined for SLIP gateway SLIP_GW. 

def 1ne_sl1p_host gateway_name=slip_xx host_name=host_2 .. 
ip_address=( 129, 179,71,2) 

—ERROR— SLIP gateway SLIP_XX Is not defined. 

define_slip_host gateway_name=slip_gw host_name=host_22 .. 
1p_address=(129, 179,71,2) 

—ERROR— IP address 129.179.71.2 1s already defined. 

deflne_slip_host gateway_name=sl1p_gw host_name=host_22 .. 
1p_address=(129, 179,71,246) host_count=20 

—ERROR— IP address 129.179.72.9 Is Invalid. 

def 1ne_slip_host gateway_name=siip_gw host_name=host_2 .. 
1p_address=(129, 179,77,2) 

—ERROR— SLIP host address 129.179.77.2 does not correspond 
to the network address 129.179.71 for SLIP gateway SLIP_GW. 
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DEFINE _SNMP_AGENT (DEFSA) 

DI Configuration Procedure/NETOU Command 

Purpose Configures the SNMP agent in a CDCNET communications device. The DI 

SNMP agent provides CDCNET users who have TCP/IP networks the 
ability to monitor, control and manage their CDCNET devices by any 
RFC- compliant SNMP Manager. 

This command defines a public community as any that accepts PDUs from 
IP addresses with read-only access modes. Only CDCNET allows commands 
of length less than 256. If necessary, you can use CHANGE _SNMP_ 
AGENT to set any variables that do not fit on the DEFINE _SNMP_ 
AGENT command. These values can also be changed by authenticated 
SNMP Managers with read-write access. The variables defined in MIB II 
(RFC 1213) and the CDCNET enterprise-specific MIB are supported. The 
SNMP Agent uses UDP to send and receive SNMP PDUs. 

Format DEFINE _SNMP_AGENT 

NAME = string 1.226 

CONTACT = string 1.226 

LOCATION = string 1..226 

MAX _PDU _SIZE = integer 484..8192 

Parameters NAME (N) 

Specifies the administratively assigned name for this communications 
device. This parameter is optional. There is no default. 

CONTACT (C) 

Specifies the contact person for this communication device, together with 
information on how to contact this person. This parameter is optional. 
There is no default. 

LOCATION (L) 

Specifies the physical location of this communication device. This 
parameter is optional. There is no default. 

MAXJPDUJSIZE (MPS) 

Specifies the maximum size PDU that an SNMP Agent can build and send 
to the peer SNMP Manager. The default is 8192, the maximum size 
support by the underlying UDP protocol. 

Responses The SNMP Agent has been defined. 

-ERROR- The UDP Interface is not defined. 

—FATAL- Not enough memory is currently available for required table 
space. 

-WARNING- The SNMP Agent is already defined. 

Remarks Programmers can find a listing of the CDCNET MIB II in file 

$SYSTEM.CDCNET.VERSION_xxxx.SNMP.CDCNET_MIB (where xxxx is 
the current CDCNET version). This file contains a listing of the VAR and 
CONST used in the CDCNET MIB II. Sites can use the VAR and CONST 
as necessary for SNMP operations. 
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DEFINE .SOURCE _ALARM .MESSAGE (DEFSAM) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the alarm messages (by specifying alarm message numbers) that 

the DI should send to the network operator. If this command is not used to 
configure a DI, no alarms are generated by the DI. 

Format DEFINE .SOURCE _ALARM .MESSAGE 

MESSAGE DUMBER = list 1..63 of integer 1..32999 

Parameters MESSAGE _Jf UMBER (MN) 

List of message numbers the DI is to send as alarms to the network 
operator. If omitted, a set of default alarm message numbers are enabled. 
See the online list of default log and alarm messages for the alarm 
message numbers and their message identifiers. The CDCNET 
Configuration Guide further explains how to access these messages. You 
may add alarms to this list using additional DEFSAM commands. You may 
also cancel messages using the CANCEL .SOURCE _ALARM .MESSAGE 
command. 

NOTE 

Canceling any of the default alarms is not recommended. 

For the complete list of diagnostic messages, see the online CDCNET 
Diagnostic Messages manual. 

Responses Source alarm messages defined. 

—ERROR— Source alarm messages are already defined. 

-FATAL- Not enough memory currently exists for required table space. 

Remarks If more than one DEFSAM command is issued to a DI, the set of alarm 
messages defined for the DI is the set specified on the most recent 
occurrence of the command, in addition to any messages specified on any 
previous DEFSAM commands (including the default alarm message 
numbers). 

Examples def i ne_sour ce_a 1 armjmessage 

Source alarm messages defined. 
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DEFINE J30URCE _LOG _GROUP (DEFSLG) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the types of log messages to be logged by this DI, and defines the 
log groups to which this DI belongs. If this command is not used to 
configure a DI, no messages are logged by the DI. 

Format DEFINE .SOURCE _LOG _GROUP 

LOGjGROUP = name 

MESSAGE JNUMBER = list 1..63 of integer 1.. 32999 

Parameters LOGjGROUP (LG) 

Name of the source log group to which the Dependent Log ME in this DI 
belongs. The parameter value must match the value of the LOG_GROUP 
parameter on the DEFINE .RECORDER _LOG_GROUP command in the 
System Configuration file for the DI that is the log recorder for this log 
group. Default is CATENET (all DIs in the network). Each DI can belong 
to only one log group. 

MESSAGE ^NUMBER (MN) 

List of message numbers that correspond to the set of messages to be 
logged by this DI. If this parameter is not specified, a CDCNET- defined set 
of log messages is selected for this DI to log. The CDCNET Configuration 
Guide explains how to access these messages. You may add or delete log 
message numbers to this list using the CHANGE _SOURCE_LOG_GROUP 
command. 

NOTE 

Omitting any of the default set of messages is not recommended. 

For the list of diagnostic messages and their numbers, see the online 
CDCNET Diagnostic Messages manual. 

Responses Source log group defined. 

-ERROR— A source log group is already defined for the system. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def lne_source_log_group 

def 1 ne_source_ 1 og_group 1 og_group= 1 og_group_a 
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DEFINE .SYSTEM (DEFS) 
DI Configuration Procedure 

Purpose Defines a DI's logical name; defines values affecting the DI's memory 

management; and, for DIs supported by NOS hosts, specifies whether or 
not the DI contains the master clock for the network. 

Format DEFINE .SYSTEM 

SYSTEM^NAME = name 

DATAJBUFFERJSIZE = 64.. 2304 

BUFFER PERCENTAGE = 1..99 

BUFFER BOUNDARY PERCENTAGES = list 3 of integer 1..99 

MEMORY BOUNDARY .PERCENTAGES = list 3 of integer 1..99 

MEMORY _MANAGER_PERJOD = 1..10 

RESERVEDJSYSTEM_SPACE = 1000..8000(16) 

STANDARD _STACK_SIZE = 0800(16). .2000(16) 

DEFAULT JCHANNELJTRUNK = name 

ROUTING _SYSTEM = boolean 

CLOCKING JSYSTEM = boolean 

MAXIMUM _RECOVERIES = 0..255 

COMPRESS _DUMP = boolean 

Parameters SYSTEM JSTAME (SN) 

Title of a DI or an Integrated Communications Adapter (ICA) board, as the 
title appears in the CDCNET directory. For a DI, the default system name 
is $DI _systemj,d, where system _id is the DI's system identifier consisting 
of 12 hexadecimal digits, as in 080025100068. An example of a default 
logical name is $DI_080025100068. For an ICA-II board, the default 
system name is $ICA _sysid, where sysid is the 12-hexadecimal-digit 
unique system address. 

If SYSTEM _NAME is specified, titles for both the specified system name 
and the default system name are registered for the DI. The system name 
appears on displays and is used in commands sent to the Network 
Operator Utility (NETOU). 

DATA_BUFFER_SIZE (DBS) 

Size, in bytes, of the system data buffers. The value of this parameter is 
stored in battery-backed RAM and the effects are not realized until a reset 
other than a power-on reset occurs. 

The actual buffer size saved is adjusted to be a multiple of a descriptor 
buffer. The following table defines the actual buffer sizes generated for 
ranges of entered data buffer size values. 
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DBS 


Buffer 


DBS 


Buffer 


Value 


Size 


Value 


Size 


64..70 


68 


1173..1210 


1208 


71..108 


106 


1211..1248 


1246 


109..146 


144 


1249..1286 


1284 


147..184 


182 


1287..1324 


1322 


185..222 


220 


1325..1362 


1360 


223..260 


258 


1363..1400 


1398 


261..298 


296 


1401..1438 


1436 


299..336 


334 


1439..1476 


1474 


337..374 


372 


1477..1514 


1512 


375..412 


410 


1515..1552 


1550 


413..450 


448 


1553..1590 


1588 


451..488 


486 


1591..1628 


1626 


489..526 


524 


1629..1666 


1664 


527..564 


562 


1667..1704 


1702 


565..602 


600 


1705..1742 


1740 


603..640 


638 


1743..1780 


1778 


641..678 


676 


1781..1818 


1816 


679..716 


714 


1819..1856 


1854 


717..754 


752 


1857..1894 


1892 


755..792 


790 


1895..1932 


1930 


793..830 


828 


1933..1970 


1968 


831..868 


866 


1971..2008 


2006 


869..906 


904 


2009..2046 


2044 


907..944 


942 


2047..2084 


2082 


945.. 982 


980 


2085..2122 


2120 


983..1020 


1018 


2123..2160 


2158 


1021..1058 


1056 


2161..2198 


2196 


1059..1096 


1094 


2199..2236 


2234 


1097..1134 


1132 


2237..2274 


2272 


1135..1172 


1170 


2275.. 2304 


2310 



Default is 144 for a DI with less than 4 megabytes of SMM and 524 for an 
ICA-II with 4 or more megabytes of SMM (set at power-up but can be 
altered if this parameter is specified). 

BUFFER PERCENTAGE (BP) 

Sets the percentage of total System Main Memory (SMM) which, after DI 
configuration, is to be turned initially into data buffers. Default is 50 
percent. 

The free memory remaining after the data buffers are allocated is called 
allocatable memory. A DI uses allocatable memory to configure and 
activate devices and to load transient processes including command 
processors. If a DI is short of allocatable memory, device configuration may 
fail or processes may fail to load. 

You may increase the amount of allocatable memory for a DI by 
decreasing its buffer percentage. If all but a few of the devices defined for 
a DI are successfully configured and activated, enough allocatable memory 
to activate all devices may be found by decreasing the buffer percentage. 
Slowly decrease the buffer percentage until all devices successfully are 
configured. A DI needs at least 100 K bytes of total system buffers (700 
buffers at default buffer size of 144 bytes) to ensure that there are enough 
buffers for normal system operation. 
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Control Data also recommends that the buffer percentage be at least 30 
percent. Below 30 percent, a DI may not have enough buffers to service 
with good performance all the configured devices. A shortage of buffers 
may cause long delays in data transmission or poor response for interactive 
terminal users. 

BUFFER JBOUNDARY ^PERCENTAGES (BBP) 
Percentages of available buffers corresponding to boundaries between 
different levels of DI buffer availability. The DI dynamically maintains the 
state of available buffers. The four defined buffer states are GOOD FAIR 
POOR, and CONGESTED. 

Specify a list of three integers that specify the three boundaries between 
the four buffer states. Default list value is (40, 20, 5). The first value 
defines the boundary value between GOOD and FAIR, the second value 
defines the boundary between FAIR and POOR, the third value defines the 
boundary between POOR and CONGESTED. Values must be listed from 
highest value to lowest. Values must differ by at least 5. 

MEMORY JBOUNDARY_PERCENTAGES (MBP) 

Percentages of available memory that correspond to boundaries between 
different levels of DI memory availability. The DI dynamically maintains 
the state of available memory. The four defined memory states are GOOD 
FAIR, POOR, and CONGESTED. 

Specify a list of three integers that specify the three boundaries between 
the four memory states. Default list value is (40, 15, 2). The first value 
defines the boundary value between GOOD and FAIR, the second value 
defines the boundary between FAIR and POOR, the third value defines the 
boundary between POOR and CONGESTED. Values must be listed from 
highest value to lowest. Values must differ by at least 5. 

MEMORY _MANAGER_PERIOD (MMP) 

Interval, in seconds, that the DI memory manager executes to maintain the 
DI buffer and memory state. Default is 1 second. Control Data recommends 
that you keep this at 1 second. 

RESERVED _SYSTEM _SPACE (RSS) 

Number of bytes to be reserved in the free memory pool for executive 
internal allocations. If specified as an odd value, this parameter is rounded 
off to the nearest integer divisible by 2. Default is 1000 bytes. 

STANDARD _STACK_SIZE (SSS) 

Size, in bytes, of the task's stack size when the initiator of the task does 
not specify a stack size to the executive. If specified as an odd value, this 
parameter is rounded off to the nearest integer divisible by 8. Default is 
2048 bytes. 

DEFAULT JCHANNEL _TR UNK (DCT) 

Specifies the default channel trunk for the configuration of NOS Network 
Product interface, gateways and Network Management Entities using NOS 
services. If a default channel trunk is not specified and the DI was loaded 
across an MCI interface, the trunk over which the DI was loaded becomes 
the default channel trunk. If a default channel trunk is not specified and 
the DI was not loaded across an MCI interface, the default channel trunk 
for the DI is not defined. 
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ROUTING J3YSTEM (RS) 

Identifies a system to be a distributor of Routing Information Data Units 
(RIDUs) when the value is set to TRUE. Systems with ROUTING _ 
SYSTEM set to TRUE generate and forward all the RIDUs and version 3 
directory PDUs. See the CHANGE .DIRECTORY command for information 
on specifying the Directory ME version. 

If the value is FALSE, the system does not generate or forward RIDUs or 
version 3 directory PDUs from other systems. If the primary (lowest cost) 
network is inactive, the system only generates RIDUs, it does not forward 
them. Setting ROUTING_SYSTEM to FALSE for all but one or two DIs on 
the redundant Ethernets reduces the amount of unnecessary RIDU traffic. 

Default is TRUE. 

CLOCKING SYSTEM (CS) 

Used only for DIs supported by NOS hosts. It indicates that the DI is to 
contain the master clock that specifies the date and time for the network. 
All other DI clocks set their date and time according to this master clock. 
Default is FALSE. 

For DIs connected to a NOS host, there must be only one clocking system 
DI defined in the catenet with CLOCKING .SYSTEM = TRUE. 

For DIs supported by NOS/VE hosts, this parameter is not needed, since 
the DIs obtain the master clock from the NOS/VE host rather than from a 
clocking system DI. 

For an MDI/MTI connected to a NOS/VE host, the value for this parameter 
should be FALSE. 

NOTE , 

Do not use this parameter for an ICA-II. 

MAXIMUM RECOVERIES (MR) 

Specifies the maximum number of task recoveries allowed in a 60-minute 
period before the DI is reset. Default is 5. 

COMPRESS _DUMP (CD) 

Requests a compressed dump (omits free memory and buffers) of DI 
memory. Possible parameter values are YES and NO. Default is NO. 

Responses The DEFINE _SYSTEM command can only be executed in a system 
configuration procedure. The following response is the only possible 
response if the DEFINE _SYSTEM command is entered through the 
Network Operator Utility (NETOU): 

-ERROR- The system is already defined. 

The following responses may be logged during DI system startup: 

The define system command is completed. 

—WARNING- System definition accepted with system not the clocking _ 
system. The system could not be started as the master clock. 
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Remarks 



-WARNING- System definition accepted with system not the clocking_ 
system. There is already a master clock in catenet. Network ID: 
xxxxxx, System Id: xxxxxxxxxxxx 

-WARNING-- The define system command is completed. Power on reset 
<P1> used, please correct. 

-ERROR- Clocking_system may not be specified for an ICA II system. 

-ERROR- Buffer _boundary_percentage values not decreasing or do not 
differ by 5. The buffer boundary percentages are <P1 P2 P3>. 

-ERROR- Memory _boundary_percentage values not decreasing or do 
not differ by 5. The memory boundary percentages are <P1 P2 P3>. 

-FATAL- The system name cannot be registered. 

You should allow for at least 100 K of memory (about 700 buffers) for 
system buffers to be available after system configuration. 

CAUTION 



Use only default values for parameters BUFFER _BOUNDARY_ 
PERCENTAGE through STANDARD_STACK_SIZE. Changing these 
values may significantly degrade performance. 



• This command is not required to be present in a DI's system 
configuration file. If this command is not present, default values are 
internally generated during initialization. 

• To change values of a DI's operating system while the DI is 
operational, use the CHANGE _SYSTEM network operator command. 

Examples def 1ne_system system_name-md1_86 

The define system command Is completed. 
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DEFINE _TCP_INTERFACE (DEFTI) 

DI Configuration Procedure/NETOU Command 

Purpose Configures the TCP interface (DOD's Transmission Control Protocol). This 
command is required if a DI supports TCP/IP. 

Format DEFINE _TCP_INTERFACE 

ACCEPT. STRATEGY = keyword value 
ACK PERCENTAGE = 0..100 
MAX^BUFFERS = 1..65535 
MAX_$EGMENT_SIZE = 1..4096 
MAX .CONNECTIONS = 0..512 
QUIETJTIME = 0..10000 
RETRANSMIT .STRATEGY = keyword value 
RETRANSMIT .TIME = 0..65535 
SECURITY .CHECKING = keyword value 
TIME.TOJJVE = 0..255 
SYNJLCK.TIME = 2..10000 
START = boolean 

Parameters ACCEPT STRATEGY (AS) 

Specifies the TCP segment accept strategy to be used. A TCP segment is a 
packet of data that contains a TCP header which is delivered by IP to its 
destination. The following keyword values are allowed: 



Keyword Value 



Description 



IN .ORDER (10) 



IN_WINDOW (rw) 



Segments are accepted only in the exact order 
they are expected. All other segments are 
discarded. 

Segments are accepted if they fall within the 
current TCP window. The TCP window is the 
amount of data a receiving TCP entity is willing 
to accept from the sending TCP entity in bytes. 
Segments outside the TCP window are discarded. 



Default is IN .WINDOW. 
CAUTION 



Using this parameter might cause performance degradation and increase 
the number of retransmitted segments. 

ACK .PERCENTAGE (AP) 

Specifies the percentage of the receive window that must be full before an 
acknowledgement is issued. Default is 50. 

MAX BUFFERS (MB) 

Specifies the maximum number of data bytes that TCP holds for a 
connection for both directions of travel. Default is 16,384 bytes. 
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MAX JSEGMENTJ5IZE (MSS) 

Specifies the maximum segment size, in bytes, to be negotiated by TCP 
when a connection is established. If the maximum datagram size of the 
first hop IP network is less than this value, the maximum datagram size 
is used as the maximum segment size. Otherwise, the value for this 
parameter is used. Default is 1456 bytes. 

MAX ..CONNECTIONS (MC) 

Specifies the maximum number of simultaneous TCP connections. This 
includes active and passive connections. Default is 200 connections. 

QUIET JTIME (QT) 

Specifies the number of seconds that TCP must wait, after a connection 
has closed, before a connection with the same source and destination socket 
addresses can be opened again. A TCP socket is an IP address and a TCP 
port identifier. This socket is used by TCP to identify a TCP user process. 
If TCP receives a connection attempt with a source and destination socket 
address that are currently in a quiet time state, TCP does not respond or 
acknowledge connection establishment. Default is 20 seconds. 

RETRANSMIT STRATEGY (RS) 

Specifies the TCP segment retransmission strategy to be used. The 
following keyword values are allowed: 

Keyword Value Description 



BATCH (B) All unacknowledged segments are retransmitted 

when the retransmission timer expires. 

FIRST_ONLY (FO) Only the first segment of a sequence of 

unacknowledged segments is retransmitted when 
the retransmission timer expires. 

ADAPTIVE (A) Each connection starts in FIRST_ONLY mode. If a 

subsequent retransmission sequence causes TCP to 
perform batch retransmission as a series of 
retransmissions, then TCP switches to BATCH 
mode. This case detects the instance where the 
peer TCP is using an IN_ORDER accept strategy. 

Default is ADAPTIVE. 
RETRANSMIT JTIME (RT) 

Specifies the initial number of seconds that TCP should wait for an 
acknowledgement before retransmitting a data segment. This value changes 
for an active connection as the actual round-trip time is learned. Default is 
3 seconds. 
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SECURITY JCHECKING (SC) 

Specifies the security checking to be performed on all segments. The 
following keyword values are allowed: 



Keyword Value 



Description 



NONE (N) 
USER_SPECIFIED (US) 

LEVEL _U (LU) 

LEVEL _C (LC) 

LEVEL _E (LE) 
LEVEL _M (LM) 

LEVEL _P (LP) 
LEVEL _R (LR) 

LEVEL _S (LS) 

LEVEL _T (LT) 

Default is NONE. 
CAUTION 



The security option supplied in IP datagrams is 
ignored. 

The security option specified by the upper-level 
protocol in the passive or active connect request 
establishes the security level of the connection. 

All connections must be at security level 
UNCLASSIFIED. 

All connections must be at security level 
CONFIDENTIAL. 

All connections must be at security level EFTO. 

All connections must be at security level 

MMMM. 

All connections must be at security level PROG. 

All connections must be at security level 
RESTRICTED. 

All connections must be at security level 
SECRET. 

All connections must be at security level TOP 
SECRET. 



If a security level is specified, all connections and all segments received on 
a connection must match that security level. Any data segments that do 
not match the security level for a connection are discarded. 
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TIME _TO_J,IVE (TTL) 

Specifies the IP time-to-live field used by TCP. This is a hop count that is 
decremented at each move (hop) of a datagram. When the hop count 
reaches zero, the datagram is purged to prevent looping. Default is 60 
| hops. 

1 SYN^ACKJTIME (SAT) 

I Specifies the maximum number of seconds that TCP should wait for an 

| acknowledgement of the initial SYN segment. The connection is aborted at 

| timeout. A SAT time too small can cause connection disconnects before the 

| remote host has time to respond. A large SAT time can cause users to 

1 wait long periods of time for an unavailable host. Default is 60 seconds. 

START (S) 

Specifies that the TCP task should be started and connection attempts are 
honored. Default is TRUE. 

Responses TCP interface is defined and started. 

-WARNING- TCP interface is already defined. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def ine_tcp_1 nter face 

TCP Interface Is defined and started. 
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DEFINE _TCPIP_GW (DEFTG) (NOS Only) 
DI Configuration Procedure/NETOU Command 

Purpose Configures a gateway that provides services to NOS CYBER-resident 

TCP/IP applications, such as File Transfer Protocol (FTP). Gateways for 
the TCP, IP, UDP, and TELNET protocols can be configured. This 
command is not needed to support TELNET interactive services. 

NOTE 

For NOS/VE applications, use the ADDTA command. 

Format DEFINE _TCPIP_GW 

GATEWAY NAME = name 

SOURCE _JP_ADDRESS = list 4 of 0.J255 

TITLE = list 1..15 of name(s) 

TRANSLATION DOMAIN = name 

PROTOCOL = list 1..4 of keyword value 

MAX CONNECTIONS = 0..65535 or INFINITE 

START = boolean 

Parameters GATEWAY_NAME (GN) 

The logical name of the gateway used in subsequent commands that 
reference the gateway. 

SOURCE JP ^ADDRESS (SIA) 

The IP address of the CYBER host for which this gateway provides service. 
This parameter is the source IP address used when the host application 
does not specify one. If the host application specifies a source IP address 
and this parameter is specified, the host source IP address is used. If the 
host application does not specify a source IP address and this parameter is 
omitted, the IP address defined for the DI is used. 

The format for this parameter is similar to the decimal octet convention 
used by TCP/IP, except the periods are replaced with commas and the list 
is enclosed in parentheses. For example, the IP address 128.2.53.7 is 
represented as (128,2,53,7). 

TITLE (T) 

Specifies the title that the host applications must use to access this 
gateway. This title must be coordinated with the Internet Protocol Access 
Method (IPAM) installation on NOS/VE, or the configuration of the NDL 
OUTCALL on NOS. Default is the value supplied for the GATEWAY. 
NAME parameter. 

TRANSLATION _POMAIN (TD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the catenet for which gateway services are to be made 
available. Default is CATENET. 



60000414 D 



DEFINE Commands 6-107 



DEPINE_TCPIP_GW (DEPTG) (NOS Only) 



PROTOCOL (P) 



Specifies the protocol supported by this gateway. The allowed keyword 
values are TCP and UDP which provide host interfaces for the respective 
protocols. This parameter controls which piece of the gateway is loaded. 
FTP requires the TCP interface. Default is TCP. 



NOTE 



User written applications may need TCP, UDP, or IP. 



MAX CONNECTIONS (MC) 

Specifies the maximum number of simultaneous connections to be supported 
by this gateway. If INFINITE is specified, there is no limit to the number 
of connections. Default is 65535. 

START (S) 

Specifies that this gateway is to be started. Default is TRUE. 

Responses TCP/IP gateway < gateway _name> is defined and started to support 
< protocol > protocol. 

TCP/IP gateway < gateway _name> is defined. 

-ERROR- TCP/IP gateway < gateway _name> is already defined. 

-ERROR- TCP/IP gateway title < title > already defined. 

-FATAL- TCP/IP gateway < gateway _name> was unable to open SAP. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_tcpip_gw gateway.name ■ ftp_gw title ■ gw_tcpip_106 .. 
protocol = tcp 

TCP/IP gateway FTP_GW Is defined and started to support TCP protocol. 
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DEFINE .TIP (DEFT) 

DI Configuration Procedure/NETOU Command 

Purpose Defines the following for each TIP: 

• A CDCNET TIP name or an optional user- defined TIP name that sites 
use to redefine TIP names. 

• A set of default TIP parameters to be used if the identical parameters 
are not supplied on the command to configure the line and terminal 
devices. 

You can specify certain parameters based on a TIP, line, or terminal 
device. These overlapping parameter definitions allow you to set values on 
the TIP rather than specifying individual parameter definitions for each 
line that the TIP is to support. Identical parameters on the DEFINE _ 
LINE, DEFINE .TERMINAL .DEVICE, and ADD_TELNET_SERVER 
commands override the parameter settings on DEFINE _TIP. 

To define the X.25 Asynchronous TIP, use the DEFINE _X25_ASYNCTIP 
command instead of DEFINE _TIP. 

To define the SNA3270 TIP, use the DEFINE _SNA3270_TIP command 
instead of DEFINE _TIP. 

Format DEFINE _TIP 

TIP_NAME = keyword value 

USERJTIPJVAME = name 
LINE JCONTROL _SUPPORT = keyword value 
FRAMING JTYPE = keyword value 
CLUSTER _JU)DRESS = 0..255 
DEVICE .ADDRESS = 0.255 
TRANSMISSION _BLOCKJSIZE = 128..4095 
TERMINAL _USER_PROCEDURE = name 
VALIDATE JJSERS = boolean 



Parameters TIP_NAME (TN) 



Specifies the name of the TIP defined by CDCNET. The following TIP 
names are allowed. Note that the suffix TIP may be omitted from a 
specified TIP name. 

ASYNCTIP or ASYNC 
HASPTIP or HASP 
URITIP or URI 
BSC3270TIP or BSC3270 
NTFTIP or NTF 
USER1TIP or USER1 
USER2TIP or USER2 
USER3TIP or USER3 
USER4TIP or USER4 
MODE4TIP or MODE4 
NJEFTIP or NJEF 
TELNETTIP or TELNET 
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If a TIP is not loaded as part of the DI load process, the first terminal 
user is likely to encounter a long delay (up to a minute on a heavily 
loaded system) before the terminal is recognized. This delay is due to the 
dynamic loading of the TIP. To avoid the delay, include a LOAD_ 
MODULE command for each TIP configured in a DI in the DI's system 
configuration procedure. The following is an example LOAD_MODULE 
command for the ASYNCTIP: 

LOAD_MODULE ASYNCTIP_MODULE 

USER_TIP_NAME (UTN) 

This parameter is used for sites that implement user TIPs (TIPs developed 
at the site rather than provided with Control Data release software) and 
want to assign a site-defined logical name to a user TIP. The USER_TIP_ 
NAME parameter is ignored if the TIP_NAME parameter does not specify" 
one of the user TIPs. When the USER_TIP_NAME parameter is specified 
along with one of the user TIP names, all subsequent commands that have 
the TIP_NAME parameter (that is, all DEFINE _LINE commands) must 
also specify the value of the USER_TIP_NAME parameter. The value for 
this parameter can be no more than 26 characters long. 

LINE _CONTROL _SUPPORT (LCS) 

Specifies the level of line control required by the TIP of the Line Control 
Module (LCM). The following keyword values are allowed. 

Keyword Value Description 



NONE Specifies that the control of the line is 

entirely the responsibility of the TIP. 

CONFIGURATION Specifies that the TIP expects LCM to perform 

the CIM configuration of the line, but that the 
TIP monitors the line's modem signals after 
the line is configured. 

FULL Specifies that the TIP expects LCM both to 

configure the line and to monitor/process its 
modem signals. 

Default is FULL. 

NOTE 



For TIPs currently provided with CDCNET using the DEFT command, LCS 
must be FULL; otherwise lines supported by these TIPs are not enabled. 
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FRAMING JTYPE (FT) 

Specifies the default framing to be used for this TIP. The following 
framing types are allowed: 

ASYNC 
SYNC 
SDLC 
PARALLEL 

The following default framing types are set for each TIP type: 

TIP Name Default Framing Type 

ASYNCTIP ASYNC 

HASPTIP, NJEFTIP, SYNC 

NTFTIP, BSC3270TIP, 
MODE4TIP 

URITIP PARALLEL 

Non-Control Data ASYNC 

provided TIPs 

CLUSTER _ADDRESS (CA) 

This parameter is used for BSC3270 and MODE4 TIPs. Specifies the 
cluster address to be used by the TIP for communication with an implicitly 
defined console device, that is, a console is implicitly defined when a line 
becomes active and no TDP has been defined by the DEFL command. This 
parameter does NOT specify a default value for subsequent DEFTD or 
DEFBD commands defined in a TDP for BSC3270 or MODE4 supported 
devices. Default is 0. 

For the MODE4 TIP, the CLUSTER _ADDRESS must be in the range of 
70(16) through 7F(16) for Mode 4A and 20(16) through 7F(16) for Mode 4C 
clusters. This parameter must be specified for the MODE4 TIP if any Mode 
4 lines are defined by a DEFL without a TDP that defines the first console 
device. 

NOTE 

In the configuration sequence that is entered at the 3270 workstation, the 
cluster address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. 



DEVICE .ADDRESS (DA) 

This parameter is used for HASP, BSC3270 and MODE4 TIPs. Specifies 
the device address to be used by the TIP for communication with an 
implicitly defined console device, that is, a console is implicitly defined 
when a line becomes active and no TDP has been defined by the DEFL 
command. This parameter does NOT specify a default value for subsequent 
DEFTD or DEFBD commands defined in a TDP for BSC3270 or MODE4 
supported devices. Default is 0. 
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For devices supported by the HASP TIP, the DEVICE .ADDRESS 
parameter is ignored if the DEVICE _TYPE= CONSOLE, and need not be 
specified. Only one console is allowed per cluster or line. All other device 
types must have a device address ranging from 1 through 7, corresponding 
to the stream number of the HASP workstation device being configured. 
The default is 1 for HASP batch devices. 

For the MODE4 TIP, the DEVICE .ADDRESS must be 61(16) for all Mode 
4A devices and in the range of 61(16) through 6FQ6) for Mode 4C devices. 
This parameter must be specified for the MODE4 TIP if any Mode 4 lines 
are defined by a DEFL without a TDP that defines the first console device. 

For the BSC3270 TIP, the device address must be in the range of 
through 31. Default is 0. 

NOTE 



In the configuration sequence that is entered at the 3270 workstation, the 
cluster address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. 



TRANSMISSION _BLOCKJSIZE (TBS) 

Specifies the transmission block size to be used by the TIP for 
communication with devices on the lines supported by the TIP. Default for 
this parameter varies according to the TIP being defined, as shown in the 
following list. 

TIP Name Default Transmission Block Size 

HASPTIP, NTFTIP, 400 

BSC3270TIP 

ASYNCTIP 450 

NJEFTIP 800 

MODE4TIP 1040 

This parameter is ignored if TIP_NAME=URITIP. The value of this 
parameter on this command can be overridden for a specific line or device 
by specifying the TBS parameter on the DEFINE JLINE, DEFINE. 
REMOTE .SYSTEM, DEFINE .BATCH .STREAM, DEFINE BATCH. 
DEVICE, and/or DEFINE .TERMINAL .DEVICE command(sI 
This value reserves input buffer space in the CIM. Use the maximum 
block size sent to CDCNET by a HASP, Mode 4, 3270 BSC, NJF, or NTF 
connection. Otherwise, CDCNET may disconnect the line because of 
excessive errors on the line. 
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Responses 



Examples 



TERMINAL _USER .PROCEDURE (TUP) 

Specifies the terminal user procedure (TUP) to be executed when a 
communication line supported by this TIP becomes active. A terminal user 
procedure file may contain most of the terminal user commands. This 
parameter lets you predefine a user's terminal environment on a TIP basis 
and to have the environment automatically set up at the time a line 
supported by this TIP becomes active. The value of this parameter on this 
command can be overridden for a specific line or device by the TUP 
parameter on the DEFINE _LINE, DEFINE _REMOTE .SYSTEM, and/or 
DEFINE .TERMINAL .DEVICE command(s). This parameter is ignored if 
TIP_NAME=URITIP. There is no default. 

VALIDATE JUSERS (VU) 

Specifies if users of this TIP are validated when validation is enabled by 
the DEFINE _USER .VALIDATION command. If TRUE is specified, 
validation is enabled. If FALSE is specified, the user of this TIP is not 
validated. Default is TRUE. 

TIP <name> defined. 

-ERROR- TIP <name> already defined. 

-ERROR- Unable to define TIP <TIP name>. No CIM is installed. 

-ERROR- TIP <name> is not a CDC defined TIP name. 

-FATAL— Not enough memory is currently available for required table 
space. 

deflne.tip t1p_name=HASPTIP 



TIP HASPTIP defined. 
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DEFINE _UDP_INTERFACE (DEFUI) 

DI Configuration Procedure/NETOU Command 



Purpose 



Configures the User Datagram Protocol (UDP) layer interface. This 
command is required if the DI is to support TCP/IP applications that use 
UDP as the underlying transport service. 

NOTE 



This command is required to configure UDP to support the Network File 
System (NFS). 



Format DEFINE _UDP_INTERFACE 

SECURITY 'CHECKING = keyword value 
TIMEJTOJjIVE = 0..255 
START = boolean 

Parameters SECURITY ..CHECKING (SC) 

Specifies the security checking to be performed on all datagrams. The 
following keyword values are allowed: 



Keyword Value 



Description 



NONE (N) 

USER .SPECIFIED 
(US) 

LEVEL_U (LU) 

LEVEL _C (LC) 

LEVEL _E (LE) 
LEVEL _M (LM) 

LEVEL _P (LP) 

LEVEL_R (LR) 

LEVEL_S (LS) 

LEVELJT (LT) 



The security option supplied in IP datagrams is 
ignored. 

The security option specified by the upper-level 
protocol in a passive or active connect request 
establishes the security level of the connection. 

All connections must be at security level of 
UNCLASSIFIED. 

All connections must be at security level of 
CONFIDENTIAL. 

All connections must be at security level of EFTO. 

All connections must be at security level of 
MMMM. 

All connections must be at security level of 
PROG. 

All connections must be at security level of 
RESTRICTED. 

All connections must be at securitv level of 
SECRET. 

All connections must be at security level of TOP 
SECRET. 



Default is NONE. If a security level is specified, all incoming datagrams 
which have the security option supplied must match this security level. 
Any datagrams that do not match the security level are discarded. 
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TIME_TOJ,IVE (TTL) 

Specifies the IP time-to-live field used by UDP. In the TCP/IP community, 
this is typically used as a hop count. When the count in a packet reaches 
zero, the packet is discarded to prevent looping. Default is 60. 

START (S) 

Specifies that the UDP should be started and service requests is honored. 
The default value is TRUE. 

Responses UDP interface is defined and started. 

UDP interface is defined. 

-ERROR— UDP interface is already defined. 

—FATAL— Not enough memory is currently available for required table 
space. 

Examples define_udp_interface . . 

time_to_live =30 

UDP interface is defined and started. 
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DEFINE_USER_TELNET_GW (DEFUTG) 

DI Configuration Procedure/NETOU Command 

Purpose Configures a user TELNET gateway, which provides CDCNET terminal 

users with access to the interactive services of remote hosts on a TCP/IP 
network. 

A site can configure a user TELNET gateway with the IP address of the 
remote host which is accessed via that gateway. A user TELNET gateway 
can also be defined with the IP address omitted or specified as NONE. The 
terminal user, in this case, must supply the IP address of a remote host 
when creating a connection to that user TELNET gateway. For a 
description of the CREATE_CONNECTION (CREC) command, including 
using the SERVICE_DATA parameter to specify the IP address, see the 
CDCNET Terminal Interface manual. 

The two timeout parameters relate to the TCP and TELNET protocols 
respectively, and impose no limits on the user. That is, a user can leave a 
connection idle for any period of time without losing the connection. 

NOTE 

The host service might impose inactivity limits of its own. 

Format DEFINE_USER_TELNET_GW 

GATEWAY_NAME = name 
IP_ADDRESS = list 4 of0..255 or keyword 
TITLE = list 1..15 of name 
TRANSLATIONJ)OMAIN - CATENET 
MAXJCONNECTIONS = 0..65535 or INFINITE 
SOURCEJP_ADDRESS = list 4 of0..255 
TCPJPORTJWMBER = 0..6S535 
TCPJILLOCATEJ5IZE - 0..7FFFFFFFC16) 
TCPJTIMEOUT = 0..65535 or INFINITE 
INACTIVITY_TIMEOUT = 0..65535 
INITIATE_OPTION_NEGOTIATION = boolean 
START - boolean 

Parameters GATEWAY_NAME (GN) 

The logical name of the user TELNET gateway used in subsequent 
commands that reference the gateway. 

IPJiDDRESS (IA) 

The IP address of the host that provides the TELNET interactive service. 
This user TELNET gateway establishes a connection using this IP address 
as the destination address. If this parameter is omitted or the keyword 
NONE is specified, the terminal user must specify the IP address of the 
remote host as "service data" when creating a connection (CREATE. 
CONNECTION) to the user TELNET gateway. The format of the IP address 
is similar to the decimal octet convention used by the TCP/IP community, 
except the periods are replaced with commas and the list is enclosed in 
parentheses. For example, the IP address 128.2.53.7 is represented as 
(128,2,53,7). 



6-116 CDCNET Commands 



60000414 G 



DEFINE_USER_TELNET_GW (DEPUTG) 



TITLE or TITLES (T) 

Specifies the title(s) by which this gateway sendee can be accessed. For 
example, this is the name that CDCNET terminal users supply in the 
CREATE_CONNECTION command. Default is the value supplied for the 
GATEWAY_NAME parameter. 

TRANSLATION_DOMAIN (TD) 

This parameter specification is allowed but the value is ignored. Specifies 
the portion of the CDCNET catenet that can access this service. Default is 
CATENET. 

MAXJCONNECTIONS (MC) 

Specifies the maximum number of simultaneous connections to be supported 
by the gateway. If INFINITE is entered, there is no restriction on the 
number of connections allowed. Default is INFINITE. 

SOURCE_IP_ADDRESS (SIA) 

Specifies the IP address of the source host to be used by this gateway. The 
format is similar to the decimal octet convention used by the TCP/IP 
community, except the periods are replaced with commas and the list is 
enclosed in parentheses. For example, the IP address 128.2.53.7 is 
represented as (128,2,53,7). Default is the IP address from the host type 
LOCAL DEFINE_IP_HOST command. 

TCP_PORT_NUMBER (TPN) 

Specifies the TCP port number to be used by the gateway. User TELNET 
issues a TCP active connect request using the service contact port (the well- 
known port) for the destination port. The default is the well-known server 
TELNET port 23. 

TCPJiLLOCATE_SIZE (TAS) 

Specifies the amount of data that the gateway queues for each connection. 
Larger values may improve user response time, especially for PC users (with 
a standard protocol such as XMODEM), but can increase the number of 
instances of DI congestion. 

CAUTION 

Specifying this value is discouraged, because poor network service might 
result. 

Default is 4096 bytes. 

TCPJTIMEOUT (TT) 

Specifies the maximum number of seconds that TCP should wait for an 
acknowledgment of data transmission. If an acknowledgment is not received 
within the specified period, TCP aborts the connection. 
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CAUTION 



Responses 



Examples 



A small TCP timeout value Cess than a few seconds) might cause frequent 
and unnecessary loss of service during periods of network congestion. A 
large TCP timeout value might leave users waiting a long period of time 
after a host or network has failed. 

If INFINITE is entered, the connection does not time out. Default is 300 
seconds. 

JNACTIVnY_TIMEOVT (IT) 

Specifies the interval (in seconds) between inactivity checks. If a connection 
has been idle for the specified time, the gateway sends a TELNET status 
request to the remote TELNET to determine if the connection is still usable. 
Default is 600 seconds. 

INITIATE_OPTION_NEGOTIATION (ION) 

Allows CDCNET to inhibit the negotiation of Telnet options on the TCP 
connections made by the User_Telnet_Gateway. Default is TRUE. 

TRUE 

CDCNET initiates the negotiation of Telnet options on the TCP 

connections made by the User_Telnet_Gateway. 

FALSE 

CDCNET inhibits the negotiation of Telnet options on the TCP 

connections made by the User_Telnet_Gatway. 

START (S) 

Specifies that the newly configured gateway is to be started after it is 
defined. Default is TRUE. 

User TELNET gateway <gateway_name> is defined and started. 

User TELNET gateway <gateway_name> is defined. 

-ERROR- User TELNET title <title> is already defined 

-FATAL- Not enough memory is currently available for required table 
space. 

define_user_telnet_gw gateway_name = gw_to_vax . . 
ip.address = (128,5,0,3) title=vax 

User TELNET gateway GW_TO_VAX is defined and started. 
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DEFINE _USER VALIDATION (DEFUV) 

DI Configuration Procedure/NETOU Command 

Purpose Designates validation for interactive users connecting to CDCNET via 

communications lines, X.25 trunks, or Telnet connections. It also defines 
the default validation domain for the DI and the number of login attempts 
allowed before disconnecting a user. 

Format DEFINE _USER ..VALIDATION 

DEFAULT_VALIDATION .DOMAIN = name 

MAXIMUM _LOGIN ^ATTEMPTS = 1..10 

Parameters DEFAULT_VALIDATION .DOMAIN (DVD) 

Specifies the default validation domain that users connected to this DI 
belong to by default. 

You can override this default by specifying your own default validation 
domain during login. 

MAXIMUM _LOGIN _ATTEMPTS (MLA) 

Specifies the number of consecutive, unsuccessful login attempts allowed 
before disconnecting a user from the network. Default is three attempts. 

Responses User validation is defined. 

Examples def ine_user_validation default_validat1on_domain-va1exp1 

User validation is defined. 
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DEFINE _VE ..INTERFACE (DEFVI) 

DI Configuration Procedure/NETOU Command 



Purpose 



Format 



Parameters 



Defines the VE interface to a NOS/VE host. 
NOTE 



An "unable to start" error leaves the interface defined but not started. 



DEFINE _VE .INTERFACE 

INTERFACE JSLOT = 0..7 
INTERFACE JiAME = name 
MAXIMUM _FRAMEJSIZE = 4424..13000 
NETWORK JB = 1..0FFFF(16) 
CHANNEL JTIMEOUT = boolean 
START = boolean 

INTERFACE _SLOT (IS) 

The number of the physical board slot which houses the MCI board. This 
parameter does not apply to an ICA-II. This parameter is required if more 
than one MCI board exists in the DI and is optional if only one MCI board 
exists in the DI. 

NOTE 



Do not use this parameter for an ICA-II. 



INTERFACE J^AME (IN) 

The logical name of the interface. The default name for an MDI is 
constructed using the MCI slot parameter, as in $MCI2. The default name 
for an ICA-II is $ICA_ICI. 

MAXIMUM _FRAME JSIZE (MFS) 

The maximum frame size which can pass over the channel. This parameter 
allows resource use of memory and processor to be shifted between the 
host and MDI or ICA-II. 

The specified value is rounded up to be a multiple of 8. Default is 8512 
bytes. 

NOTE 



If the interface is not the boot source, maximum frame size takes effect 
when the interface becomes operational. If the interface is the boot source, 
a reset is forced at the end of configuration and the maximum frame size 
takes effect after the next reset. 
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NETWORK JD (NI) 

A network ID used to form a unique network address for routing messages 
to the host through this DI or ICA. If the host has more than one channel 
connected to the same network front end or to different front ends, then 
this parameter must be specified. The unique network ID ensures that all 
messages sent to a specific host connection arrive at the DI or ICA 
processing that connection. If this parameter is not specified, the network 
address used for this channel is formed from the network ID specified with 
the NAMATS definition information entered during NOS/VE configuration. 

CHANNEL JTIMEOUT (CT) 

Specifies how the MCI software handles host peripheral processor (PP) 
interrupts. This parameter is intended for use by customers during joint 
software development with Control Data. The following values are allowed: 

Value Description 

TRUE The MCI software detects when a host PP stops 

operating, downs the channel interface, and 
attempts recovery. 

FALSE The MCI software does not detect when a host PP 

stops operating. FALSE should be specified only 
for the debugging of host PP software. 

Default is TRUE. 

START (S) 

Specifies whether or not the configured element should be started. Default 
is TRUE; started. 

CDCNET does not currently support network operator commands to start, 
stop, or cancel a VE interface. Therefore, do not specify START = FALSE. 
There is no way to start a VE interface if START = FALSE is specified on 
DEFINE _VE .INTERFACE. 

Responses VE interface < interface _name> is defined. 

VE interface < interface _name> is defined and started. 

-ERROR- VE interface < interface _name> is already defined. 

-ERROR- Interface slot may not be specified for an ICA II system. 

-ERROR- Interface slot < interface _slot> does not contain a CHANNEL 
board. 

-ERROR- The Device Interface does not contain a CHANNEL board. 

-ERROR- The Device Interface contains more than one CHANNEL board 
— the interface slot must be specified. 

-ERROR- Network _id < network _id> is already defined. 

-ERROR- Specified CHANNEL board is not on. 

-ERROR- Specified CHANNEL board is already in use. 
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Remarks 



Examples 



-FATAL- Not enough memory is currently available for required table 
space. 

-FATAL- Stream Service error. Not enough memory is currently available 
for required table space. 

-FATAL- Stream Service error. Unable to open statistics SAP. 

-FATAL- Stream Service error. Unable to open memory management SAP. 

-FATAL- Stream Service error. Unable to initialize MCI board. 

-FATAL- Unable to start task < entry _point_name>. 

• This command is required only in DI systems to be configured with a 
VE interface. This command is not required in systems booted over the 
channel running the VE interface. If this command is performed for the 
channel over which the device boot was received, it serves to define the 
NETWORK _ID parameter and redefine parameters INTERFACE _ 
NAME, MAXIMUM _FRAME_SIZE, and CHANNEL _TIMEOUT.~To 
redefine the VE interface over which the DI was booted, this command 
must be in the configuration file. 

• If you use a value above 13000 for the MAXIMUM _FRAME_SIZE 
parameter, no error will be reported, but the PP driver hangs. 

You will get optimum throughput by setting the channel message size 
to a value that corresponds to optimum use of the other media in the 
communications device. For example, in an MDI connected to Ethernet, 
the Transport layer breaks a channel message into blocks containing 
1412 bytes of user data. Optimum channel message sizes for this MDI 
are multiples of 1412 plus 40 bytes for channel protocol overhead. 
CDCNET modifies the value specified for MAXIMUM _FRAME_SIZE 
by rounding up to the next multiple of eight. Since this could result in 
an extra Ethernet block, the value specified should first be rounded 
down to the next lower multiple of eight. Recommended values for 
MAXIMUM _FRAME_SIZE are 5688, 7096, 8512, 9920, 11336, and 
12744. 

Applications that use the TCP/IP protocols typically use messages of 
8000 bytes. Throughput of these applications is improved somewhat 
when these messages fit in a single channel message. Therefore, any 
value above 8000 should improve the throughput of these applications. 

A key factor in selecting a maximum channel message size is the 
amount of memory available in the communications device. Use values 
above 5688 only if the device contains three megabytes of memory or 
more. 

def1ne_ve_ Inter face lnterface_s1ot=4 .. 
Inter f ace_name=nos_ve_ 1 nt er f ace_ 1 st ar t «no 



VE Interface nos_ve_1nterface_1 Is defined. 



6-122 CDCNET Commands 



60000414 D 



DEFINE Jt25_ASYNCTlP (DEFXA) 



DEFINE _X25 _ASYNCTIP (DEFXA) 

DI Configuration Procedure/NETOU Command 

Purpose Defines X.25 Asynchronous TIP support for one or more X.25 trunks, and 
defines the set of default TIP parameters for those trunks. The services 
defined for asynchronous terminals connected through X.3 Packet 
Assembler/Disassemblers (PADs) are similar to those provided by the 
ASYNC TIP to terminals connected through asynchronous lines. 

This command includes terminal usage parameters that, for lines controlled 
by the ASYNC TIP, are defined through the DEFINE _LINE command. 
DEFINE _X25_ASYNCTIP includes these parameters since the virtual 
circuits by which terminal users establish connections to the X.25 
Asynchronous TIP are determined dynamically. This means that defining 
terminal usage on the basis of virtual circuit (equivalent to definition by 
DEFL) is not possible. Instead, this command defines these usage 
parameters for all virtual circuit connections for the trunks named in the 
command. Since the DEFXA command may be specified for each trunk, 
different usage parameters may be specified per trunk. 

Format DEFINE _X25 _ASYNCTIP 

TRUNK .NAME = list 1..32 of name(s) 

TERMINAL JDEFINITION _PROCEDURE = name 
TERMINAL _USER PROCEDURE = name 
PROCEDURE _FILE JOPTION = keyword value 
CALLED _J)TE _ADDRESS _RANGE = range of 1..15 
CONNECTION JCONNECT JTIMEOUT = 20..1000 or INFINITE 
CONNECTION DISCONNECT JTIMEOUT = 0..1000 or INFINITE 
USER JCONNECTION JalMIT = 1..16 
ACCEPT _REVERSE _CHARGES = boolean 
START = boolean 

PERMANENT _VIRTUAL JCIRCUITS = list 1..64 range of 1.. 4095 
. PVCJCHANNELJCONCATENATION = boolean 
PVCJPACKET_$IZE = 16..1024 
PVC _WINDOW_SIZE = 1..127 
VALIDATE JUSERS = boolean 

Parameters TRUNK _NAME (TN) 

Specifies the logical names of one or more X.25 trunks to be serviced by 
the X.25 Asynchronous TIP. 

TERMINAL DEFINITION ^PROCEDURE (TDP) 

Specifies the name of a terminal definition procedure (TDP) file. The 
commands within the named file are executed when a virtual circuit 
becomes active. Default is that no TDP is automatically executed for the 
virtual circuit. 

TERMINAL _USER JPROCEDURE (TUP) 

Specifies the name of a terminal user procedure (TUP) file. The commands 
within the named file are executed each time a virtual circuit connection 
to a terminal becomes active. This parameter is ignored if a TDP (see TDP 
parameter) is specified. Default is that no TUP is automatically executed 
for the virtual circuit. 
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PROCEDURE _FILE JOPTION (PFO) 

This parameter allows for additional options for configuring switched 
virtual circuit terminal devices and attributes. The following keyword 
values are allowed: 

Keyword Value Description 



LOGICAL .CHANNEL _ Appends the X.25 logical channel number 

CONCATENATION (LCC) (LCN) to the TDP's or TUPs file name. 

For example, TDP=TDP_PDN_FILE 
becomes TDP.PDN .FILE .fen.." 

CALLED_DTE_ Appends the called DTE address to the 

CONCATENATION (CDC) TDPs or TUPs file name. For example, 

TDP = TDP_PDN_FILE becomes TDP_ 
PDN _FILE .called _dte .address. 

CALL _DATA .PROCEDURE Selects the option to treat call data 
(CDP) information as if it were a TDP file name. 

Default is that the specified TDP or TUP file is executed for all switched 
virtual circuits (SVCs). That is, no concatenation of LCN or called DTE 
address and no procedure filename is in the call data information. 

CALLED JDTE ^ADDRESS JRANGE (CDAR) 

Specifies the range of the called DTE address to be used for concatenation 
when the CALLED.DTE .CONCATENATION option is selected for the 
PROCEDURE .FILE .OPTION parameter. This parameter is ignored if 
PROCEDURE .FILE .OPTION is not equal to CALLED.DTE. 
CONCATENATION. Default is that the entire DTE address is used. 

CONNECTION JCONNECT JTIMEOUT (CCT) 

Defines how much time the terminal user has to create the first 
$INPUT/$OUTPUT connection. The range is 20 through 1000 seconds. If no 
connection is established within that time, the virtual circuit is cleared. It 
may be necessary to increase this value if the VALIDATE .USERS 
parameter is TRUE. The keyword INFINITE indicates an infinite time. 
The timer has a precision of +/- 2 seconds. Default is 120 seconds. 

CONNECTION DISCONNECT JTIMEOUT (CDT) 

Defines how much time the terminal user has to establish a new 
$INPUT/$OUTPUT connection after the last such connection is 
disconnected. If no new connection is' established within that time, the 
virtual circuit is cleared. The range is through 1000 seconds. Default is 
120. The keyword INFINITE indicates an infinite time. The timer has a 
precision of +/- 2 seconds. 

USER JCONNECTION _LIMIT (UCL) 

Defines the maximum number of $INPUT/$OUTPUT connections allowed at 
any one time by a user. The range is 1 through 16 connections. Default is 
4. 
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ACCEPT REVERSE JCHARGES (ARC) 

Specifies whether or not the X.25 Asynchronous TIP should accept 
incoming calls with reverse charges specified. Default is FALSE; reverse 
charges are not accepted. 

START (S) 

Specifies whether or not the configured X.25 Asynchronous TIP should 
begin to accept incoming calls for terminal connections. Default is TRUE; 
started. 

PERMANENT ^VIRTUAL JCIRCUJTS (PVC) 

Specifies the permanent virtual circuit logical channel numbers (in CCITT 
terminology, the logical channel group number and the logical channel 
number) the X.25 Asynchronous TIP supports. The maximum number of 
PVCs per trunk name is restricted to 64. 

PVCs may be listed individually, or as a range, for example, 
PVC=(1,2,3,4,5,11..16) or PVC = (1..5,11..16), provided the total number of 
PVCs does not exceed the maximum 64 logical channels. 

The logical channel numbers used must be within the range of the PVC_ 
RANGE parameter value on the DEFINE _X25 .INTERFACE command. 

This parameter is used in conjunction with the PVC .CHANNEL _ 
CONCATENATION, PVC _PACKET_SIZE, and PVC_WINDOW_SIZE 
parameters. 

PVC JCHANNEL JCONCATENATION (PCC) 

This parameter is used in conjunction with the preceding PERMANENT_ 
VffiTUAL .CIRCUITS parameter, and is only significant when PVCs have 
been defined. This parameter controls whether logical channel 
concatenation is to be performed on PVC logical channels. Default is 
FALSE. 

If a TDP or TUP file name is specified, and PCC is TRUE, the PVC 
logical channel number is appended to the TDP or TUP file name; for 
example, TDP_PDN_FILE_fcn or TUP_PDN_FILE_fcn. 

PVC _J>ACKET _SIZE (PPS) 

This parameter is used in conjunction with the preceding PERMANENT. 
VIRTUAL .CIRCUITS parameter, and is only significant when PVCs have 
been defined. This parameter defines the default packet size to be used by 
all defined PVC channels. 

If specified, this parameter overrides the default packet size parameter 
value (DEFAULT_PACKET_SIZE parameter on the DEFINE _X25_ 
INTERFACE command) when permanent virtual circuits are defined, and 
this packet size is used on all permanent virtual circuits. Default is the 
DEFAULT_PACKET_SIZE value on the DEFINE _X25 JNTERFACE 
command. 

PVC _WINDOW_SIZE (PWS) 

This parameter is used in conjunction with the preceding PERMANENT. 
VIRTUAL .CIRCUITS parameter, and is only significant when PVCs have 
been defined. The parameter value defines the window size to be used by 
ALL defined PVC channels. 
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If specified, this parameter value overrides the default window size 
parameter value (DEFAULT_WINDOW_SIZE parameter on the DEFINE. 
X25_INTERFACE command) when permanent virtual circuits are defined, 
and is used on all permanent virtual circuits. Default is the DEFAULT. 
WINDOW_SIZE value on the DEFINE _X25 .INTERFACE command. 

VALIDATE JUSERS (VU) 

Specifies if users of this X.25 AsyncTip are validated when the validation 
is enabled by the DEFINE _USER .VALIDATION command. If TRUE is 
specified, validation is enabled. Default is TRUE. 

Responses X.25 AsyncTip support defined for specified trunks. 

X.25 AsyncTip support defined and started for specified trunks. 

-ERROR- Trunk < trunk _name> is not a X.25 trunk. 

-ERROR- X.25 Interface has not been defined (DEFXI) on trunk < trunk _ 
name>. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- Trunk < trunk _name> already assigned X.25 AsyncTip support. 

-ERROR- Duplicate trunk name < trunk _name> specified. 

-ERROR- The number of supported PVC channels per trunk is restricted 
to <nn>. 

-ERROR- PVC_WINDOW_SIZE is greater than 7 and DEFXI PSN 
parmeter is NORMAL for trunk < trunk _name>. 

-ERROR- Logical channel number <nn> is not defined (DEFXI 
command, PR parameter) for trunk < trunk _name>. 

—ERROR- Logical channel number <nn> is already assigned to another 
user for trunk < trunk _name>. 

-FATAL- Not enough memory available for required table space. 

Examples define_x25_asynct1p trunk_name=x25_telenet 

X.25 AsyncTip support defined for specified trunks. 
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DEFINE _X25_GW (DEFXG) 

DI Configuration Procedure/NETOU Command 

Purpose This command, along with the ADD_X25_GW_INCALL (ADDXGI) and 

ADD_X25_GW_OUTCALL (ADDXGO) commands, defines X.25 application 
gateway service for one or more X.25 trunks. This command establishes a 
logical association between the trunks, enabling them to be viewed as one 
logical link to the public data network (PDN). 

The command defines the X.25 protocol identifiers for which incoming calls 
are accepted by the gateway for these trunks. Two parameters specify the 
protocol identifiers, one for calls to be routed to NOS/VE systems or other 
gateways, and one for calls to be routed to NOS systems. This command, 
and the ADDXGO command, also define the CDCNET titles by which this 
gateway definition (the association of trunks) is known throughout 
CDCNET. The ADDXGO command defines titles by which NOS/VE 
applications or other gateways may direct outgoing calls to the X.25 trunks 
defined for the gateway. The X.25 addressing is supplied for the application 
on the ADDXGO command when using these titles. 

Additional titles are specified by two parameters on the DEFXG command. 
One parameter specifies a list of port numbers by which NOS applications 
may direct outgoing calls to the associated trunks. NOS applications 
making calls through this gateway must construct their OUTCALL blocks 
with a PORT field equal to one of the defined port numbers. The other 
parameter specifies a list of site- defined titles by which NOS/VE 
applications may direct outgoing calls to the X.25 trunks defined for the 
gateway. 

Refer also to the ADD_X25 _GW_INCALL and ADD_X25_GW_OUTCALL 
command descriptions in this manual. 

Format DEFINE _X25 GW 

GATEWAY.NAME = name 

TRUNK .NAME = list 1..32 of name(s) 

NOS PROTOCOL JD = list 1..7 of 2. .255 

CDCNET .PROTOCOL JD or VE .PROTOCOL JD = list 1..7 of 

2.. 255 

NOS JORTJJ UMBER = list 1..15 of 1..0FC(16) 

VE_OUTCALL_TITLE = list 1..15 of name(s) 

START = boolean 

DTE .ADDRESS .PROTOCOL JD = list 1..7 of 0.. 255 

Parameters GATEWAY.NAME (GN) 

Specifies the logical name of the gateway to be used in subsequent 
commands that reference the gateway. This gateway name must be unique 
within the catenet. 

TRUNK .NAME (TN) 

Specifies the logical name or names of one or more X.25 trunks to be 
serviced by the X.25 gateway. The X.25 trunks must all belong to the 
same PDN. If trunks for other PDNs are to be serviced by an X.25 
gateway, separate gateway definitions for each PDN must be specified. 
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NOS .PROTOCOL JD (NPI) 

Specifies one or more protocol IDs that identify incoming calls to be routed 
to NOS mainframes by host node number. The default NOS protocol IDs 
are C0(16) and Cl(16). A NOS protocol ID must be unique for an X.25 
trunk. 

CDCNET JPROTOCOL JD (CPI) or VE JPROTOCOL _ID (VPI) 

Specifies one or more protocol IDs that identify incoming calls to be routed 
to NOS/VE systems or other gateways by application title. Default is 
C2(16). A CDCNET protocol ID must be unique for an X.25 trunk. 

NOS JORTJSfUMBER (NPN) 

Specifies a list of NOS port numbers used for NOS outgoing calls to the 
X.25 network. The NOS applications access the X.25 network supported by 
this gateway definition by constructing OUTCALL blocks with a PORT 
field value equal to a defined port number. 

If NDL OUTCALL statements have a PORT parameter value not equal to 
(that is, any value but zero), then that PORT number must match the 
value of the NOS_PORT_NUMBER parameter on an X.25 gateway. 

VEjOUTCALLJTITLE (VOT) 

Specifies a list of titles that NOS/VE applications can use to access this 
gateway. These titles are used to support outgoing calls by NOS/VE 
applications to the X.25 network supported by this gateway definition. 
Default is no NOS/VE outcall titles are registered. This parameter is not 
used by NOS-only environments. 

START (S) 

Specifies whether or not the gateway should be started after it is 
configured. Default is TRUE; started. 

DTE _M>DRESS PROTOCOL _JD (DAPI) 

Specifies one or more protocol IDs that identify incoming calls to be routed 
to CDNA server applications, by constructing a title from the protocol ID 
and the called DTE address. If incoming calls contain no protocol ID, this 
parameter should be set to 0, because the DTE address is the only means 
to identify the called application in that case. The default is that the 
protocol ID and the DTE address, by themselves, cannot identify the called 
application. A DTE address protocol ID must be unique for an X.25 trunk. 

You can use the title generated here to connect to a VE_OUTCALL_ 
TITLE at another X.25 gateway. The format of the title is 'DTE_xx_yyyy* 
where xx is the protocol ID and yyyy is the called DTE address. 
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Responses X.25 gateway < gateway _name> is defined. 

X.25 gateway < gateway _name> is defined and started. 

-ERROR— X.25 gateway < gateway _name> is already defined. 

-ERROR- The specified X.25 trunks do not connect to the same PDN. 

-ERROR- X.25 gateway < gateway _name> is not defined. 

-ERROR— X.25 gateway < gateway _name> Protocol ID already assigned. 

-ERROR— Trunk name < trunk _name> may not appear more than once 
in the list of specified trunks. 

—ERROR— Protocol ID < protocol _id> may not appear more than once in 
the list of protocol IDs. 

-ERROR— VE_outcall_title <name> may not appear more than once in 
the list of specified VE Outcall Titles. 

-ERROR- NOS_port_number < value > may not appear more than once 
in the list of specified NOS Port Numbers. 

-FATAL- X.25 gateway - not enough memory available for required table 
space. 

Remarks If CONS has been defined and started, X.25 Packet Level sends all 

incoming calls with no user data to CONS. If CONS has not been defined 
and started, X.25 Packet Level sends all incoming calls with no user data 
to the user that has defined a protocol ID of 0. 

Examples def 1ne_x25_gw gateway_name=x25_gw trunk_name=X25TELENET, . . 
nos_port_number=05( 16) 

X.25 gateway x25_gw is defined. 



600004H F 



DEFINE Commands 6-129 



DEFINEJC25 .INTERFACE (DEFXI) 



DEFINE _JX25 ..INTERFACE (DEFXI) 

DI Configuration Procedure/NETOU Command 

Purpose Defines the Packet Level parameters of the X.25 interface. This command 
includes parameters that define the ranges for permanent, incoming- only, 
two-way, and outgoing- only virtual circuits. Although the PVC_RANGE, 
INONLY_RANGE, TWOWAY_RANGE, and OUTONLY_RANGE virtual 
circuit range parameters are all optional, at least one range must be 
specified if the command is to execute successfully. If more than one range 
is specified, the associated PVC .RANGE, INONLY_RANGE, TWOWAY_ 
RANGE, and OUTONLY_RANGE value ranges must be in ascending order, 
with no overlapping of the value ranges. 

This command is normally used with a DEFINE _X25_TRUNK command. 
It can also be used with a DEFINE _LLC_2_TRUNK command. When the 
peer LLC 2 entity resides in a CDCNET device, static configuration is 
normally not needed. The DEFINE _LLC_2_TRUNK and DEFINE _X25_ 
INTERFACE commands are simulated internally in the CDCNET device. 
However, when the peer LLC 2 entity resides in a non-CDCNET device, 
the DEFINE _LLC_2_TRUNK and DEFINE _X25 INTERFACE commands 
are needed, especially in defining the X.25 virtual circuit ranges. 

Several parameter values on this command must match the values assigned 
in your public data network (PDN) subscription. Review your PDN 
subscription values before using this command. 

Format DEFINE _X25 .INTERFACE (DEFXI) 

TRUNK _NAME = name 
PUBLIC _DATA .NETWORK = keyword value 

INTERFACE _NAME = name 

LOCAL JDTE ^ADDRESS = 1..15 of string 

PACKET JSEQUENCE JWMBERWG = keyword value 

PVCJRANGE = range of 1.. 4095 

INONLY_RANGE = range of 1..4095 

TWOWAY_RANGE = range of 1..4095 

OUTONLY_RANGE = range of 1.. 4095 

DEFAULT _WINDOW_SIZE = 1.127 

DEFAULT _PACKET_SIZE = 16.. 4096 

CONGESTED JTHRESHOLD = 12.255 

START = boolean 

INTERFACE STANDARD = CCITT_1980 or CCITT_J984 

SUBSCRIBED _FACILITIES = list 1..2 of keyword 

VALIDATE JLDA = boolean 

Parameters TRUNK _NAME (TN) 

Specifies the name of the trunk to be used by the X.25 interface. This 
name must be unique in the catenet and must be coordinated with the 
trunk name specified on the DEFINE _X25_TRUNK or the DEFINE. 
LLC_2_TRUNK command. 
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PUBLIC _DATA .NETWORK (PDN) 

Specifies the name of the PDN for trunks connected to X.25 PDNs. 
Allowed keyword values include the following: 

TELENET 

TYMNET 

UNINET 

CDSN 

DATAPAC 

TRANSPAC 

USERPSN1 

USERPSN2 

USERPSN3 

USERPSN4 

PSS 

For X.25 trunks connected to the PDNs TELENET or DATAPAC, you must 
specify the keywords TELENET or DATAPAC to allow proper 
interoperation with these PDNs. For X.25 trunks that are not connected to 
PDNs, you can use this parameter to supply trunk subtype information (for 
example, WATS or INWATS). The value of this parameter is reported in all 
accounting messages related to this X.25 interface. 

INTERFACE J^AME (IN) 

Logical name of the X.25 interface. This name is used to see the X.25 
interface in subsequent commands. Default is TRUNK _NAME value. 

LOCAL _DTE_ADDRESS (LDA) 

Specifies the local data terminal equipment (DTE) address associated with 
this X.25 interface. This parameter is specified as a string of digits with 
values ranging from through 9, and this string must match the DTE 
address assigned at subscription time. The local DTE address may be used 
by applications in outgoing call requests to specify the X.25 interface and 
trunk over which the call should be made. If this parameter is not 
specified, the X.25 interface cannot be selected by applications using the 
local DTE address. 

CONS puts this given address in the calling DTE field for all call requests 
going out over this X.25 interface (except when operating over an LLC 2 
trunk, in which case, null DTE addresses are the default). However, CONS 
can be configured (see ADD_CONS_OUTCALL) with a LOCAL _DTE_ 
ADDRESS that can override the value configured by this command. 

PACKET _SEQUENCE_NUMBERING (PSN) 

Specifies the X.25 packet sequence numbering to be used for this interface. 
The following keyword values are allowed. 

Keyword Value Description 

NORMAL Specifies normal X.25 packet numbering performed 

using modulo 8. 

EXTENDED Specifies extended packet numbering performed 

using modulo 128. 

Default is NORMAL. 
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The PSN must be coordinated with the optional user facilities selected in 
your PDN subscription. 

PVCJRANGE (PR) 

Specifies the range of logical channel numbers (in CCITT terminology, the 
logical channel group number and the logical channel number) to be used 
for permanent virtual circuits. This parameter must match your PDN 
subscription value. This parameter is ignored if the specified trunk was 
defined by DEFINE _LLC_2_TRUNK (PVCs are not supported for LLC 2 
trunks). 

INONLYJRANGE (IR) 

Specifies the range of logical channel numbers (in CCITT terminology, the 
logical channel group number and the logical channel number) to be used 
for incoming calls only. This parameter value must match your PDN 
subscription value. 

TWOWAY^RANGE (TR) 

Specifies the range of logical channel numbers (in CCITT terminology, the 
logical channel group number and the logical channel number) to be used 
for either incoming or outgoing calls. This parameter value must match 
your PDN subscription value. 

OUTONLYJRANGE (OR) 

Specifies the range of logical channel numbers (in CCITT terminology, the 
logical channel group number and the logical channel number) to be used 
for outgoing calls only. This parameter value must match your PDN 
subscription value. 

DEFAULT _WINDOW_SIZE (DWS) 

Specifies the window size to be used for virtual calls for this interface if 
window size is not negotiated in the virtual calls. Default is 2. This 
parameter value must match your PDN subscription value. 

DEFAULT _PACKETJSIZE (DPS) 

Specifies the data packet size, in bytes, to be used for virtual calls for this 
interface if packet size is not negotiated in the virtual calls. The following 
packet sizes are allowed for CCITT_1980. 

16 

32 

64 

128 

256 

512 

1024 

Additional values of 2048 and 4096 are allowed for CCITT_1984. This 
parameter value must match your PDN subscription value. Default is 128. 
Value of this parameter must be coordinated with the maximum frame size 
configured for the underlying trunk. It must be smaller than the value of 
the maximum frame size for the trunk by at least 4 bytes. 

The value should be specified only if the nonstandard default packet sizes 
facility has been subscribed for this interface. 
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CONGESTED JTHRESHOLD (CT) 

Specifies the number of messages in the interface outgoing queue at which 
the interface is considered congested. Default is 12. 

START (S) 

Specifies whether or not the configured element should be started. Default 
is TRUE; started. 

INTERFACE _STANDARD (IS) 

Specifies the X.25 standard to be used for this interface. CCITT_1980 
specifies that the 1980 version of the CCITT X.25 recommendation should 
be used. Annex A of ISO 8878 is not supported when running the CCITT 
1980 X.25 standard. 

This parameter is ignored if the specified trunk was defined by DEFINE _ 
LLC _2 .TRUNK. CCITT_1984 is always used for LLC 2 trunks. 

SUBSCRIBED .FACILITIES (SF) 

Specifies the X.25 facilities which have been subscribed for this interface. 
The value is specified as a list of one or two keywords from the following 
list. 

FLOW_CONT_PARAMETER .NEGOTIATION (FCPN) 
NONSTAND_DEFAULT_PACKET_SIZES (NDPS) 
NONE 
ALL 

Default is NONE. However, if a value is specified for the DPS parameter 
of this command, it is assumed that the nonstandard default packet sizes 
facility has been subscribed. Then the default value is changed to the 
keyword NONSTAND_DEFAULT_PACKET_SIZES. 

VALIDATE JLDA (VL) 

Specifies whether the incoming packets should have the local DTE address 
validated. This parameter exists only for OSI conformance tests. During 
testing, the local DTE address must be validated. Default is NO. 

X.25 packet level users can negotiate the maximum packet size for each 
virtual circuit if the flow control parameter negotiation facility has been 
subscribed. At present, only the OSI Connection mode network service 
(CONS) software takes advantage of this facility. CONS uses the maximum 
frame size for the underlying trunk for this negotiation. 

If the nonstandard default packet sizes facility has been subscribed, then a 
value can be specified for the DEFAULT_PACKET_SIZE parameter of this 
command. 

Responses X.25 Interface < interface _name> defined and started. 

X.25 Interface < interface _name> defined. 

—ERROR- X.25 Trunk < trunk _name> is not defined. 

-ERROR- Trunk < trunk _name> is not an X.25 Trunk. 

-ERROR- X.25 Interface already defined for trunk < trunk _name>. 

-ERROR- X.25 Interface < interface _name> is already defined. 



Remarks 
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-ERROR- Expecting digit in DTE A found = < value >. 

-ERROR- Default packet size of < value > is not a valid X.25 packet size. 

-ERROR- No logical channel assignments defined. 

—ERROR- Specified channel assignments result in overlapping pvc, in-only, 
two-way, or out- only channels. 

-ERROR- Default window size may not be greater than 7 for NORMAL 
packet sequence numbering. 

-ERROR- Default packet size must be at least 4 bytes smaller than the 
maximum frame size for the underlying X.25 trunk < trunk _name>. 

—FATAL- Not enough memory is currently available for required table 
space. 

Examples define_x25_i interface trunk_name=X25TELENET .. 

publ 1c_data_net work-telenet interface_name=X25TEL twoway_range=1 . .32 

X.25 interface X25TELENET defined. 
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DEFINE _X25_NET (DEFXN) 

DI Configuration Procedure/NETOU Command 

Purpose Configures a CDCNET X.25 network solution, using a virtual circuit on a 
previously defined X.25 trunk. 

Format DEFINE _X25 _NET 

TRUNK _NAME = name 

REMOTE _DTE ADDRESS = 1..15 of string 

NETWORK _ID = 1..0FFFF(16) 

NETWORK JIAME = name 

COST = 0..7FFFFFFF(16) 

RELAY _JlLL0WED = boolean 

ROUTING JNFOJVETWORK = boolean 

NETWORK JPROTOCOL JD = 2.255 

ACCEPT _PDN_CHARGES = boolean 

START = boolean 

ARCHITECTURE JTYPE = list 1.2 of keyword value 

OUTPUT JQUEUE JLIMIT = 10000..500000 

INCOMING _SERVICE .ACCESS = list 1..11 of keyword value 

OUTGOING ^SERVICE ^ACCESS = list 1..11 of keyword value 

Parameters TRUNK .NAME (TN) 

Specifies the name of the X.25 trunk to use for the network solution. The 
trunk name must be the one defined for the trunk by the TRUNK _NAME 
parameter on the DEFINE _X25_TRUNK command. 

REMOTE _DTE .ADDRESS (RDA) 

Specifies the remote data terminal equipment (DTE) address for this X.25 
network. This parameter is specified as a string of digits with values of 
through 9. The RDA is called when the X.25 network is established from 
this system. The calling address on an X.25 call indication received for 
this network is also validated against the RDA address. A call with an 
invalid calling address is cleared. 

NETWORK _ID (NI) 

CDCNET network identifier of the X.25 network solution. The network ID 
must be unique within the catenet. 

NETWORK_JtAME (NN) 

Logical name of the network solution used in subsequent commands 
referencing the network solution. The default name is constructed from the 
NETWORK _ID parameter, using the format $NET_xxxxx, where xxxxx is 
the network ID expressed in decimal. For example, a network ID of 200 
results in a default name of $NET_200. 
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COST (C) 



The relative cost of the X.25 network solution as a path for routing data 
through the network. The cost of a network may be calculated by dividing 
100 million by the data rate of the network in bits per second. For 
example, the cost of a trunk with a speed of 56000 bits per second is 
06FA(16). If the cost specified is greater than 0FFFF(16), 0FFFF(16) is 
used for the value of the COST parameter for compatibility reasons. If the 
trunk speed specified on the DEFINE _X25_TRUNK command is 1200, 
default is 0FFFF(16). 

CDCNET routing uses cost to determine the least- cost routes for 
interconnecting networks. If multiple paths are available, the least-cost 
path is used. As a network becomes congested, its cost increases. 

RELAY ALLOWED (RA) 

Specifies how the DI may use this network for the relaying of traffic 
through the DI. Default for an X.25 network solution is TRUE. If RA is 
TRUE, the DI relays traffic between this network and other connected 
networks regardless of the definition of the other networks. If RA is 
FALSE, the DI still relays traffic between this network and any connected 
networks defined with RA=TRUE. If RA is FALSE, the DI system does 
not relay traffic between this network and other connected networks 
defined with RA= FALSE unless no other nonrestricted route exists between 
the networks. 

The following example illustrates these rules. 



Network A DI Network B 

RA=FALSE RA=TRUE 




Network C 
RA=FALSE 

Relay Between; Allowed/Not Allowed; 

Network A and Network B Allowed (RA is TRUE for Network B). 

Network A and Network C Not allowed (RA is FALSE for both 

Network A and Network C). 

Network B and Network C Allowed (RA is TRUE for Network B). 

ROUTING _JNFO_NETWORK (RIN) 

Specifies whether or not the network solution is to carry CDCNET routing 
information. Routing information pertains both to the proprietary CDCNET 
IS-IS routing protocol, as well as the ES-IS routing protocol. If RIN is 
TRUE, routing information describing ail the networks to which this 
system is attached is sent over this network solution. If RIN is FALSE, 
routing information is not sent by this system over the network solution. 
This system appears, then, as not connected to any network other than this 
network solution. Default is TRUE; network solution carries CDCNET 
routing information. 
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NETWORK JPROTOCOLJD (NPI) 

Specifies the protocol ID that identifies incoming calls for the X.25 
network. Default is C3(16). If more than one DEFINE _X25_NET command 
is encountered for the same trunk name, each NPI value on each 
DEFINE _X25_NET command must be unique. 

ACCEPT _J>DN JCHARGES (APC) 

If the value of APC is TRUE, this system may call the remote DTE 
address with normal charging and may accept a call with normal or 
reverse charging from the remote DTE address. If the value of APC is 
FALSE, this system may call only the remote DTE address with reverse 
charging requested and may accept only calls with normal charging from 
the remote DTE address. Default is TRUE; system accepts PDN charges. 

START (S) 

Specifies whether or not the X.25 network solution should be started after 
it is configured. Default is TRUE; started. 

ARCHITECTURE JTYPE (AT) 

This parameter is no longer supported. Specification is valid but the value 
is ignored. 

OUTPUT _QUEUE JLIMIT (OQL) 

Maximum data, in bytes, retained in the output queue for the network 
solution if the DI's operating system buffer queue state is poor or worse. If 
messages must be discarded, newest output messages are discarded first. 
Default depends on the cost of the network (see COST parameter). If the 
cost is 6FA(16) or greater, then the default output queue limit is 30000 
bytes. Otherwise, default is 60000 bytes. 

INCOMING _SERVICE_ACCESS (ISA) 

Specifies which services may be accessed coming in via the network 
solution. The keyword values are: 

Keyword Value Description 



ALL All services are allowed. 

NONE No services are allowed. 

application Any service not identifiable by keyword 

batch _support, interactive, file ..transfer, 
or network .management. 

batch _support Any batch input and output services are 

allowed. This includes batch control 
facility, batch job submittal, and batch 
output. 
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Keyword Value 



Description 



interactive 



nos _interactive 
passthrough 



t_passthrough 



user_telnet 



x25 _ terminal _gw 



All interactive services are allowed. 
Interactive service supports terminal user 
access. Specifying this keyword is the 
same as specifying all of the following 
interactive service keywords: nos_ 
interactive, passthrough, t_passthrough, 
user_telnet, x25_terminal_gw, and ve_ 
interactive. 

All interactive services provided by NOS 
mainframes are allowed. 

All site- defined passthrough services are 
allowed. A site- defined passthrough service 
is provided when a passthrough title is 
created during the execution of a 
Terminal User Procedure (TUP) when a 
line is activated. This service allows 
asynchronous interactive devices to make 
connections to passthrough titles of this 
type through asynchronous ports and 
exchange information using CDCNET's 
transparent data feature. 

All user- defined passthrough services are 
allowed. A user- defined passthrough 
service is provided when an interactive 
terminal user creates a connection to the 
interactive passthrough server, and defines 
a passthrough title either by entering the 
required commands manually or by 
executing a Terminal User Procedure 
(TUP) via the DO command on the 
$CDCNET_COMMAND connection. This 
service allows asynchronous interactive 
devices to make connections to 
passthrough services of this type through 
asynchronous ports and to exchange 
information using CDCNET's transparent 
data feature. 

All TELNET services are allowed. User 
TELNET is an interactive service which 
provides CDCNET terminal users with 
access to the interactive services of remote 
hosts on a TCP/IP network. 

All X.25 terminal services are allowed. 
The X.25 terminal gateway is an 
interactive service which provides 
CDCNET asynchronous terminal users 
with access to the interactive services of 
remote hosts on an X.25 network. 
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Keyword Value 



Description 



ve ..interactive 
file_transfer 

network _management 
Default is ALL. 



All interactive services provided by 
NOS/VE mainframes are allowed. 

All QTF/PTF file transfer services are 
allowed. File transfer services support 
user file (PTF) and queue file transfers 
(QTF). 

All network alarm, clock, command, file, 
and log services are allowed. 



OUTGOING J3ERVICE ^ACCESS (OSA) 

Specifies which services may be accessed going out via the network 
solution. See the ISA parameter for the keyword values. 

Responses X25 network < network _name> defined for trunk <trunk_name>. 

X25 network < network _name> defined and started for trunk < trunk _ 
name>. 

-ERROR- Network < network _name> already defined for trunk < trunk _ 
name>. 

-ERROR- Trunk < trunk _name> is not defined. 

-ERROR- Trunk < trunk _name> is not a X.25 trunk. 

—ERROR- Network name < network _name> already defined. 

-ERROR- Network ID < network _id> already defined. 

-ERROR- Protocol ID <id> already assigned. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def ine_x25_net trunk_name=X25TELNET, .. 

remote_dte_address='6124821234',network_name=X25NET,network_1d*0a(16) 

X25 network X25NET defined for trunk X25TELNET. 
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DEFINE _X25 ..TERMINAL _GW (DEFXTG) 
DI Configuration Procedure/NETOU Command 

Purpose Defines the X.25 terminal gateway service for one or more X.25 trunks. It 
establishes a logical association between the trunks so the trunks can be 
viewed as one logical link to the PDN. 

DEFXTG also defines a CDCNET title, which is used by CDCNET 
asynchronous terminal users to connect to the gateway in order to access 
applications available in an X.25 network. 

Format DEFINE _X25 ..TERMINAL GW 

GATEWAY_NAME = name 
TRUNK _NAME = list 1..32 of name 

TITLE = name 

OUTCALL J)EFINITION _REQUIRED = boolean 

START = boolean 

Parameters GATEWAY_NAME (GN) 

Specifies the logical name of the gateway used in subsequent commands 
which reference the gateway. 

TRUNK _NAME (TN) 

Specifies the logical name(s) of one or more X.25 trunks to be serviced by 
the X.25 gateway. The X.25 trunks must all belong to the same PDN. If 
trunks for other PDNs are to be serviced by an X.25 gateway, then a 
separate gateway definition must be specified for each PDN. 



TITLE (T) 

Specifies a title that the X.25 terminal gateway registers. This allows 
terminal users to create a connection to the X.25 terminal gateway. It 
interactively enters the DTE address of the foreign application or selects a 
preconfigured DTE address. The default is the value supplied for the 
GATEWAY_NAME parameter. 

OUTCALL_DEFINITION .REQUIRED (ODR) 

Specifies whether or not outcalls (see the ADDXTGO command in this 
manual) must be defined by the network administrator before the X.25 
terminal manual gateway can become fully operational. It allows the 
network administrator to control or restrict terminal users access/use of the 
X.25 terminal gateway. 

If this parameter is TRUE, the terminal user may establish a foreign 
connection only to a DTE address that matches a DTE address entered by 
the network administrator on the ADDXTGO command. The title is not 
registered until an ADDXTGO has been performed. If this parameter is 
FALSE (outcalls not needed), unrestricted access is allowed. Default is 
FALSE. 

START (S) 

Specifies whether or not the gateway should be started. The default value 
is TRUE (started). 
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Responses X.25 terminal gateway < gateway _name> is defined. 

X.25 terminal gateway < gateway _name> is defined and started. 

X.25 terminal gateway < gateway _name> is defined and awaiting outcall 
definition. 

-ERROR- X.25 terminal gateway < gateway _name> is already defined. 

-ERROR- The specified X.25 trunks do not connect to the same PDN. 

-ERROR- Trunk name < trunk _name> is not an X.25 trunk. 

-ERROR- Trunk name < trunk _name> may not appear more than once 
in the list of specified trunks. 

-ERROR- X.25 terminal gateway title < title > is already defined. 

-FATAL- X.25 terminal gateway - not enough memory available for the 
required table space. 

Examples This example allows any asynchronous terminal user in the CDCNET 
network to connect to the DATAPAC title and call any X.25 remote 
application connected to the DATAPAC PDN. 

def1ne_x25_terminal_gi* gateway_name=datapac_gateway .. 

trunk_name=datapac_trunk .. 

tltle=datapac .. 

outcal l_def inition_required=FALSE . . 

start =TRUE 

X.25 terminal gateway datapac_gateway is defined and 
started. 
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DEFINE _X25 JTRUNK (DEFXT) 

DI Configuration Procedure/NETOU Command 

Purpose Configures an X.25 trunk by defining the layer 2 parameters of an 
interface to an X.25 network. 

Format DEFINE _X25 JTRUNK 

LIM - 0..7 
PORT = 0..3 

TRUNK ^NAME = name 

MODE = keyword value 

MAX JUNACK .FRAMES = 0..7 

PFJRECOVERYJTIMER = 500..65535 

RETRANSMISSION JLIMIT = 1.. 65535 

TRUNK _SPEED = keyword value 

CLOCKING = keyword value 

INTERACTIVE BANDWIDTH = 1..9 

DRIVER = keyword value 

MAX _FRAME JSIZE = 132..32768 

Parameters LIM (L) 

LIM number for the port to which the X.25 line is connected. 

PORT (P) 

Port number for the port to which the X.25 line is connected. 

TRUNK JNAME (TN) 

Logical name of the X.25 trunk. The default name is constructed from the 
LIM and PORT parameters, as in $LIM3_PORTl. 

MODE (M) 

Mode of operation of the X.25 trunk. The following keyword values are 
allowed. 



Keyword Value 



Description 



DCE 



DTE 



Specifies that the DI operates as the Data 
Communications Equipment end for the X.25 
trunk. 

Specifies that the DI operates as the Data 
Terminating Equipment end for the trunk. 



Default is DTE. 



MAX JUNACK _JRAMES (MUF) 

Window size specifying the maximum number of frames the local station 
can send without receiving an acknowledgement (X.25 CCITT parameter 
K). Default is 7 frames. 
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PF ^RECOVERY JTIMER (PRT) 

Value of the P/F recovery timer in milliseconds. This timer initiates 
recovery when an acknowledgement is not received within this time period 
(X.25 CCITT timer Tl). Default is 500 milliseconds. 

The following table shows the optimum values for PF_RECOVERY_ 
TIMER, based on trunk speed. 



Trunk Speed 


PRT i 


1200 


32000 


2400 


16000 


4800 


8000 


9600 


4000 


19200 


2000 


38400 


1000 


48000 


750 


56000 


500 


64000 


500 


128000 


500 


256000 


500 



RETRANSMISSION _LIMIT (RL) 

Maximum retransmissions allowed. Default is 5 retransmissions. 

TRUNK_SPEED (TS) 

Speed of the X.25 trunk in bits per second. The LIM uses trunk speed to 
generate data clocking for the trunk (except when clocking is external), 
and to configure the trunk with proper values for network cost and output 
queue limit. Trunk speed is also used by NETCU to set the value for the 
PF_RECOVERY_TIMER ERROR _RECOVERY_TIMER parameter (see 
table in PF_RECOVERY_TIMER parameter description). The possible 
values for this parameter are: 

1200 

2400 

4800 

9600 

19200 

38400 

48000 

56000 

64000 

128000 

256000 

Default is 56000. Specifying a trunk speed that differs from the actual 
speed, even if you have specified EXTERNAL clocking, results in 
suboptimal performance. 
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CLOCKING (C) 

Specifies whether the LIM internally generates the clock signal for data on 
this trunk or uses an externally generated clock signal for data on the 
trunk. If the LIM generates the data clock signal, the clocking rate is 
derived from the TRUNK _SPEED parameter. The following keyword 
values are allowed: 



Keyword Value 



Description 



EXTERNAL The LIM derives data clocking for both receive 

and transmit data from external signals 
(TRUNK _SPEED is then informational only). The 
EXTERNAL receive data clock is derived from the 
RS-232 DD circuit for RS-232 ports, or the RS-449 
SR circuit for RS-449 ports. The EXTERNAL 
transmit data is derived from the RS-232 DB 
circuit for RS-232 ports, or the RS-449 ST circuit 
for RS-449 ports. 

INTERNAL Specifies that the LIM generates the clocking for 

both transmit and receive data. A single clock 
signal is generated; it matches the TRUNK _ 
SPEED specified for the trunk. The LIM supplies 
the clock on the RS-232 DA or RS-449 TT circuit. 

TRANSMIT The LIM generates clocking for transmit data, but 

derives clocking for receive data from an external 
source. The transmit data clock matches the trunk 
speed specified for the line. The LIM supplies the 
transmit data clock on the RS-232 DA circuit (for 
RS-232 ports) or the RS-449 TT circuit (for RS-449 
ports). The LIM derives the receive data clock 
from the RS-232 DD circuit (for RS-232 ports) or 
the RS-449 SR circuit (for RS-449 ports). 

Default is EXTERNAL. 

Clocking should be INTERNAL or TRANSMIT for X.25 trunks connected 
directly to terminal equipment (without intervening modems). Clocking 
should be EXTERNAL for X.25 trunks with modems. 

INTERACTIVE JBANDWIDTH (IB) 

Specifies the percentage of the trunk bandwidth to be used to transmit 
data at interactive priority. Default is 7. For example, a value of 7 on this 
parameter results, on average, in 70 bytes of interactive priority data for 
every 30 bytes of batch priority data. 
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DRIVER (D) 

Specifies the type of HDLC driver used for this X.25 trunk. The following 
keyword values are allowed: 



Keyword Value 



Description 



HDLC_NORMAL 

HDLC256 
HDLC3x64 



Operates with other line types on the same CIM. 
It operates one HDLC line at 64 K bits per 
second and a combination of HDLC lines not 
exceeding 22,000 characters per second. 

Operates one HDLC line at 128 K bits per second 
or 256 K bits per second on a dedicated CIM. 

Operates one to three HDLC lines at speeds up to 
64 K bits per second per line on a dedicated CIM. 



Default is HDLC_NORMAL. 

MAX _FRAME _SIZE (MFS) 

Specifies the maximum frame size of the HDLC frame which may be 
transmitted. 

The value of this parameter must be coordinated with the value of the 
MAX .DATAGRAM _SIZE parameter in the DEFINE _IP_NET command or 
the DEFAULT_PACKET_SIZE parameter in the DEFINE _X25_ 
INTERFACE command if these commands configure an IP network or X.25 
interface over this trunk. Default is 1500. 

Responses X.25 trunk < trunk _name> defined. 

-ERROR- Trunk name < trunk _name> already defined. 

-ERROR- The Device Interface does not contain a CIM board. 

-ERROR- Specified LIM, PORT is already in use. 

-ERROR- Specified LIM, PORT is not on. 

-ERROR- LIM <xx>, PORT <yy> is not installed in this system. 

-ERROR- LIM <xx>, PORT <xx> addresses a port that cannot be 
serviced. More than 48 ports are attached to CIMxx. Ports beyond the 48th 
port attached to a CIM are not serviced. 

-ERROR- Not enough CIM memory available to load <xxx> I/O 
Processor. 

-ERROR- Line_speed < integer > is not supported for an X.25 trunk. 

-ERROR- X.25 is not supported on the specified LIM. 

-ERROR- A line or trunk that is already defined is serviced by the same 
CIM as this trunk. The HDLC256 driver requires the CIM to be dedicated 
to this trunk. 

-ERROR- A line that is already defined is serviced by the same CIM as 
this trunk. The HDLC3X64 driver requires the CIM to be dedicated to 
HDLC or X.25 trunks. 
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-ERROR- A trunk that is already defined for driver < driver > is serviced 
by the same CIM as this trunk. A CIM can only support one HDLC driver. 

-ERROR- Three HDLC or X.25 trunks that are already defined are 
serviced by the same CIM as this trunk. The hdlc3X64 driver cannot 
support more than three trunks. 

-ERROR- The DI was loaded via this HDLC trunk and the CIM switch 
setting specified the hdlc256 driver. The driver cannot be changed to hdlc_ 
normal or hdlc3x64 since these drivers do not handle high line speeds and 
communication could be lost. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def1ne_x25_trunk Hm=0 port=0 trunk_name=X25TELNET 
X25 trunk X25TEL.NET defined. 
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DELETE _ARP_REPORTED_NETS (DELARN) „ 7-2 

DELETE _CLNS .FILTER (DELCF) 7-21 

DELETE _CONS_INCALL (DELCI) 7-2.3 

DELETE_CONS_OUTCALL (DELCO) 7-2.5 

DELETE _CONS_1980_X25 .MAPPING (DELC1XM) 7-3 

DELETE _EGP_REPORTED_NET (DELERN) 7-5 

DELETE _INCOMING_SERVICE .ACCESS (DELISA) 7-6 

DELETE _IP_FILTER (DELIF) 7-6.1 

DELETE _NON_CDC .ADDRESS .PREFIX (DELNCAP) 7-7 

DELETE_NON_CDC_ROUTING_ENTRY (DELNCRE) 7-9 

DELETE _OUTGOING_SERVICE .ACCESS (DELOSA) 7-11 

DELETE _RIP_SERVICE (DELRS) 7-12 

DELETE _SNMP_COMMUNITY (DELSC) 7-12 1 

DELETE _TCPIP_ACCESS (DELTA) 7-12 2 

DELETE _TELNET_SERVER (DELTS) 7-13 

DELETE _X25_GW_INCALL (DELXGI) 7-14 

DELETE _X25_GW_OUTCALL (DELXGO) 7-15 

DELETE _X25_GW_PVC (DELXGP) 7-16 

DELETE _X25_INCALL (DELXI) 7-16.1 

DELETE _X25 .SWITCH (DELXS) 7-18 

DELETE _X25 .TERMINAL _GW_OUTCALLS (DELXTGO) 7-21 
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This chapter provides complete descriptions of all CDCNET Network Operations 
DELETE commands. Command descriptions are organized alphabetically by full 
command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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DELETE _ARP_REPORTED NETS (DELARN) 
NETOU Command 

Purpose Deletes an IP reported network entry for the specific source IP network. 

Format DELETE _ARP_REPORTED NETS 

SOURCE _IP_NETWORk""= list 1..4 of 0..255 

Parameters SOURCE _IP_NETWORK (SIN) 

Specifies the network or subnetwork from which ARP requests are received 
for other networks. The DI is no longer restricted from sending ARP 
replies to the specified source IP network, from which ARP requests are 
received for other IP networks. The DI can now respond to all ARP 
requests from the source IP network. 

Responses Reportable IP network/subnet is deleted for source IP network/subnet 
< source _ip _network > . 

-ERROR- Reportable IP network/subnet is not defined for source IP 
network/subnet < source _ip _network > . 

Remarks The ADD.JVRP_REPORTED_NETS command supplies a list of destination 
IP networks. Any ARP request to the DI from the SOURCE _IP_ 
NETWORK are only responded to by the DI if the IP network is on that 
destination list defined in the ADD_ARP_REPORTED_NETS command 
The DELETE _ARP_REPORTED_NETS command takes off the destination 
restrictions and allows the DI to respond to all ARP requests from the 
SOURCE _IP_NETWORK. 

Examples delete_arp_reported_nets source_i p_network = (192,5,209) 

Reportable IP network/subnet is deleted for source IP 
network/subnet 192.5.209. 
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DELETE _CLNS ^FILTER (DELCF) 
NETOU Command 



Purpose Deletes a CLNS filter entry, previously defined using the ADD_CLNS_ 

FILTER command. To delete a CLNS filter, both address prefix parameters 
from the command must exactly match the CLNS filter entry. If ALL 
(default value) is specified for both of the address prefix parameters, all 
CLNS filter entries for the specified network are deleted. You cannot 
specify ALL for only one of the address prefix parameters. 

Format DELETE _CLNS ..FILTER 

NETWORK _NAME = name 

SOURCE _ADDRESS JPREFIX = string 2. .40 or ANY or ALL 
DESTINATION _ADDRESS ^PREFIX = string 2..40 or ANY or ALL 

Parameters NETWORK _NAME (NN) 

Identifies the name of a currently defined network within this system. This 
is the network on which the CLNS filter entry to be deleted is defined. 

SOURCE _ADDRESS _PREFIX (SAP) 

Specifies the NSAP address prefix of the CLNS filter entry to delete. The 
keyword ANY matches a CLNS filter entry whose SOURCE _ADDRESS_ 
PREFIX parameter is ANY. If ALL is specified for both of the address 
prefix parameters, all CLNS filter entries for the specified network are 
deleted. An address prefix must include an even number of hexadecimal 
digits. The default is ALL. 

DESTINATION _ADDRESS _PREFIX (DAP) 

Specifies the NSAP address prefix of the CLNS filter entry to delete. The 
keyword ANY matches a CLNS filter entry whose DESTINATION _ 
ADDRESS .PREFIX is ANY. If ALL is specifed for both of the address 
prefix parameters, all CLNS filter entries for the specified network are 
deleted. An address prefix must include an even number of hexadecimal 
digits. The default is ALL. 

Responses The specified CLNS filter entry is deleted from network < network _ 
name > . 

All CLNS filter enties are deleted from network < network _name>. 

-WARNING- No CLNS filter entires are defined for network <network_ 
name > . 

—ERROR- Network < network _name> is not defined. 

—ERROR- The specified CLNS filter entry is not defined on network 
< network _name > . 

—ERROR- ALL cannot be specified for just one of the address prefix 
parameters. 

-ERROR- The NSAP address prefix < address _prefix> contains an odd 
number of digits. 

—ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 
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1 -FATAL- Not enough memory available for required table space. 

I 

I Examples delete_clns.ff Iter network _name»NETW0RK1 source_address_pref 1x='044723FF' .. 

| destination_address_pref 1x='0032004556' 



I 



The specified CLNS filter entry is deleted from network NETWORKl. 

delete.clns.f i 1 ter network_name*NETWORK 1 . . 
source.address jpref 1x=al 1 dest inat ion.address jiref 1x=al 1 

All CLNS filter entries are deleted from network NETWORKl. 

delete.clns.f liter nn=NETN0RK1 sap*'044723FF' dap-' 0032004556' 
—ERROR— The specified CLNS filter entry 1s not defined for network NETWORKl. 

delete.clns.f i Iter nn=NETWORK2 sap='044723FF' dap=' 0032004556' 
—ERROR— Network NETW0RK2 is not defined. 

delete_clns.fi Iter nn=NETWORKl sap='044723FF' dap=ALL 
—ERROR— ALL cannot be specified for just one of the address prefix parameters. 

delete.clns.f liter nn=NETWORKl sap='044EEFHH' dap='0032004556' 

—ERROR— The NSAP address prefix 044EEFHH contains non-hexadecimal characters. 
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DELETE _CONS .INCALL (DELCI) 
NETOU Command 

Purpose Deletes one or more previously configured CONS incall definitions added 
by the ADD_CONS JNCALL command. 

Format DELETE _CONS JNCALL 

ADDRESS .PREFIX = list 1..10 of string 2..40 or ALL 

Parameters ADDRESS _PREFIX (AP) 

Specifies the set of NSAP address prefixes associated with the CONS incall 
definition entries to be deleted. Use the value ALL to delete the entries for 
all addresses. The elements of each string defining an address prefix must 
be hexadecimal digits, unless you specify ALL. 

Responses The following response is generated if the value of the address prefix 
parameter specifies a single address prefix: 

The CONS incall definition entry for the NSAP address prefix 

< address _prefix> is deleted. 

The following response is generated if the value of the address prefix 
parameter specifies a list of two or more address prefixes: 

The CONS incall definition entries for the following NSAP address 

prefixes are deleted. 

{The above line is followed by a list of address prefixes. Please see the 

command response example for the format in which this information is 

displayed.} 

The following response is generated if a value of ALL is specified for the 
address prefix parameter: 

CONS incall definition entries for all NSAP address prefixes are 
deleted. 

The following response is generated if no address prefixes have been 
configured, regardless of input errors: 

-WARNING- No CONS incall definition entry for any NSAP address 
prefix is defined. 

The following response is generated if a requested address prefix has not 
been configured: 

-ERROR- A CONS incall definition entry for the NSAP address prefix 

< address _prefix> is not defined. 

The following response is generated if an ADDRESS _PREFIX parameter 
contains an odd number of digits: 

-ERROR- The NSAP address prefix < address _prefix> contains an odd 
number of digits. 
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The following response is generated if an ADDRESS JPREFIX parameter 
contains a nonhexadecimal character. 

-ERROR- The NSAP address prefix < address .prefix > contains 
non-hexadecimal characters. 

Examples deiete.cons.incaii address_prefix='044723FF' 

The CONS incall definition entry for NSAP address prefix 044723FF is deleted. 

delete.cons.incall address_pref ix«('044723FF', '44AAEEFF') 

The CONS incall definition entries for the following NSAP address prefixes are deleted. 

044723FF 
44AAEEFF 

de lete.cons. i nca 1 1 address_pref 1 x= ' a 1 1 ' 

CONS incall definition entries for all NSAP address prefixes are deleted. 

de lete.cons. 1 nca 1 1 address_pref ix='044EEFHH' 

—ERROR— The NSAP address prefix 044EEFHH contains non-hexadecimal characters. 
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DELETE _CONS_OUTCALL (DELCO) 
NETOU Command 

Purpose Deletes one or more previously configured CONS outcall definitions added 

by the ADD_CONS_OUTCALL command. 

Format DELETE _CONS _OUTCALL 

ADDRESS .PREFIX = list 1-10 of string 2..40 or ALL 

Parameters ADDRESS .PREFIX (AP) 

Specifies the set of NSAP address prefixes associated with the CONS 
outcall definition entries to be deleted. Use the value ALL to delete the 
entries for all CONS outcall definition entries for addresses. The elements 
of each string defining an address prefix must be hexadecimal digits, 
unless you specify ALL. 

Responses The following response is generated if the value of the address prefix 
parameter specifies a single address prefix: 

The CONS outcall definition entry for the NSAP address prefix 
< address _prefix> is deleted. 

The following response is generated if the value of the address prefix 
parameter specifies a list of two or more address prefixes: 

The CONS outcall definition entries for the following NSAP address 

prefixes are deleted. 

{The above line is followed by a list of address prefixes. Please see the 

command response example for the format in which this information is 

displayed.} 

The following response is generated if a value of ALL is specified for the 
address prefix parameter: 

CONS outcall definition entries for all NSAP address prefixes are 
deleted. 

The following response is generated if no address prefixes have been 
configured, regardless of input errors: 

-WARNING- No CONS outcall definition entry for any NSAP address 
prefix is defined. 

The following response is generated if a requested address prefix has not 
been configured: 

-ERROR- A CONS outcall definition entry for the NSAP address 
prefix < address _prefix> is not defined. 

The following response is generated if an ADDRESS _PREFIX parameter 
contains an odd number of digits: 

—ERROR— The NSAP address prefix < address _prefix> contains an odd 
number of digits. 
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The following response is generated if an ADDRESS _PREFIX parameter 
contains a nonhexadecimal character: 

-ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 

Examples delete_cons_outcall address_pref ix='044723FF' 

The CONS outcall definition entry for NSAP address prefix 044723FF 1s deleted. 

delete_cons_outcall address_pref 1x=('044723FF', '44AAEEFF') 

The CONS outcall definition entries for the following NSAP address prefixes are deleted. 

044723FF 
44AAEEFF 

delete.cons.outcal 1 address _pref ix=' al 1 ' 

CONS outcall definition entries for all NSAP address prefixes are deleted. 

deiete_cons_outcal 1 address _pref ix='044EEFHH' 

—ERROR— The NSAP address prefix 044EEFHH contains non-hexadecimal characters. 
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DELETE _CONS _1980 _X25 .MAPPING (DELC1XM) 
NETOU Command 

Purpose Deletes a previously configured NSAP address combination used to route 

incoming CONS/TPO traffic received from a 1980 X.25 PDN. This command 
deletes routing information that was previously added via the ADD_ 
CONS_1980_X25 .MAPPING command. 

Format DELETE _CONS _1980 _X25 .MAPPING 

DESTINATION .NSAP.ADDRESS = string 2..40 or ALL 

DESTINATION _J)TE _JU)DRESS = string 1..15 
SOURCE JSISAP ^ADDRESS = string 2. .40 
SOURCE JDTE _ADDRESS = string 1..15 

Parameters DESTINATION .NSAP.ADDRESS (DNA) 

Specifies the destination NSAP address that represents the routing entry to 
be deleted. The elements of the string entered must contain an even 
number of hexadecimal digits. If ALL is specified, all entered addresses are 
deleted. 

DESTINATION J)TE .ADDRESS (DDA) 

Specifies the destination DTE address that represents the routing entry to 
be deleted. The elements of the string entered must contain decimal digits. 
This parameter is required if the ADDC1XM information being deleted was 
used to define the DDA. 

SOURCE JXSAP_ADDRESS (SNA) 

Specifies the source NSAP address that represents the routing entry to be 
deleted. The elements of the string entered must contain an even number 
of hexadecimal digits. This parameter is required if the ADDC1XM 
information being deleted was used to define the SNA. 

SOURCE J3TE ^ADDRESS (SDA) 

Specifies the source DTE address that represents the routing entry to be 
deleted. The elements of the string entered must contain decimal digits. 
This parameter is required if the ADDC1XM information being deleted was 
used to define the SDA. 

Responses The following information for routing incoming CONS/TPO traffic has been 
deleted: 

Destination NSAP address = < destination _nsap .address > 
Destination DTE address = < destination _dte .address > 
Source NSAP address = < source _nsap .address > 
Source DTE address = < source .dte .address > 

All CONS 1980 X.25 routing information has been deleted. 

-WARNING- The given information for routing incoming CONS/TPO traffic 
is not defined. 

-WARNING- No CONS 1980 X.25 routing information exists. 

-ERROR- The NSAP address <nsap address > contains non-hexadecimal 
characters. 
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-ERROR- The NSAP address <nsap address > contains an odd number of 
digits. 

-ERROR- The DTE address <dte address> contains non-decimal 
characters. 

Examples delete_cons_1980_x25_mapp1ng dda=' 1234567' .. 

dna='39840f01bb7b0000000000000 1080025 10008401' . . 
sda= ' 7890 1 2 ' sna= ' 4700040003000 1 20230 1 1 007000 1 ' 

Destination NSAP address = 39840f01bb7b0000000000000108002510008401 

Destination DTE address * 1234567 

Source NSAP address - 4700040003000120230110070001 

Source DTE address = 789012 



de1ete_cons_1980_x25_mapping .. 
dna= '39840f 1 bb7b0000000000000 1 080025 1 000840 1 ' 

Destination NSAP address = 39840f01bb7b0000000000000108002510008401 
Destination DTE address = Not Specified 

Source NSAP address - 39840f01bb7b0000000000000108002510007201 
Source DTE address = Not Specified 



deldxm al 1 
All CONS 1980 X.25 routing Information has been deleted. 

delclxm dda=' 1234567' dna='0000000008002510008G' 

—ERROR— The NSAP address 00000000080025 10008G 
contains non-hexadecimal characters. 
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DELETE _EGP_REPORTED NET (DELERN) 
NETOU Command 

Purpose Deletes the definition of an IP network address which EGP reports to its 
peers. 

Format DELETE JEGPJREPORTED _NET 

IP^NETWORK = list 1..3~of 0..255 or keyword value 

Parameters IP_NETWORK (IN) 

Specifies the IP network for which peer reporting is to be deleted. Specify 
an IP network number if the reporting on a specific IP network is to be 
deleted. The following keyword values are also allowed. 

Keyword Value Description 



Responses 



Examples 



ALL 



NONE 



The entire list of reported local networks is deleted 
and EGP reverts to reporting all networks that the 
DI has learned. 

The entire list of reported local networks is deleted 
and EGP stops reporting any network numbers. 



Default is NONE. 

EGP reported network <ip_network> is deleted. 

EGP reported network deleted, ALL are reported. 

EGP reported network deleted, NONE are reported. 

-ERROR- EGP network <ip_network> is not defined. 

delete_egp_reported_net in - (128,5) 

EGP reported network 128.5 is deleted. 
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DELETE .INCOMING .SERVICE ACCESS (DELISA) 
NETOU Command 

Purpose Deletes previously added titles of servers that may be accessed coining in 
via the network solution. 

Format DELETE .INCOMING .SERVICE .ACCESS 

TITLE = list 1..15 of name or string 1..255 

NETWORK NAME = name 

Parameters TITLE (T) 

Specifies a title of a server that may be accessed coming in via the 
network solution. The title must match a previously added title exactly, 
including any wildcards. 

Title is case-sensitive when entered as a string. For example, a title 
entered in uppercase with the ADDISA command must always be entered 
in uppercase on this command, or it is seen as a different title. 

NETWORK _NAME (NN) 

Identifies the name of a currently defined network within this system. This 
is the network solution upon which the accessible services are being 
defined. Default is the previously defined network when on the 
configuration file. It is required when entered by the operator. 

Responses Incoming service access deleted from network < network _name>. 

-WARNING-- Incoming service access deleted from network < network _ 

name>. 

Title < title > not found. 

{Line repeats for each title not found} 

-ERROR- A network is not defined. 

—ERROR- Network < network _name> is not defined. 

-ERROR- Title .< title > may not appear more than once in the list of 
specified titles. 

-ERROR- Expecting NAME or STRING, found <xxx>. 

Examples delete_1ncom1ng_servlce_access t1tle='ARH907' network_name=$NET_15 

Incoming service access deleted from network $NET_15. 
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DELETE _IP_FILTER (DELIF) 
NETOU Command 

Purpose Deletes IP filter entries, previously defined using the ADD_IP_FILTER 

command. All IP address, IP mask, protocol, and port number parameters 
from the command must exactly match for an IP filter entry to be deleted. 
If either IP address parameter is set to ALL or not specified (defaults are 
ALL), other parameters are ignored and all IP filter entries for the 
specified IP network are deleted. 

Format DELETE _IP_FILTER 

IP.NETWORK = list 1..4 of integer 0..255 

SOURCE _IP_ADDRESS = list 1..4 of integer 0..255 or ANY or ALL 
DESTINATION _IP_ADDRESS = list 1..4 of integer 0..255 or ANY or 

ALL 

SOURCE JPJdASK = list 1..4 of integer 0..255 or HOST 
DESTINATION _JP_MASK = list 1..4 of integer 0..255 or HOST 
PROTOCOL = integer of 1..254 or keyword value 

SOURCE _PORT_NUMBER = list 1..10 of integer of 0.. 65535 or ANY 
DESTINATION JPORT _NUMBER = list 1..10 integer of 0..65535 or 

ANY 

Parameters IP.NETWORK (IN) 

Identifies an IP network currently defined within this system. This is the 
network on which the IP filter entry to be deleted is defined. 

SOURCE JPJiDDRESS (SIA) 

Specifies the source IP address of the IP filter entry to be deleted. The 
keyword ANY matches an IP filter entry whose SOURCE _IP_ADDRESS is 
ANY. If ALL is specified for both of the address prefix parameters, all IP 
filter entries for the specified network are deleted. The default is ALL. 

DESTINATION _JP ^ADDRESS (DIA) 

Specifies the destination IP address of the IP filter entry to be deleted. The 
keyword ANY matches an IP filter entry whose DESTINATION _IP_ 
ADDRESS is ANY. If ALL is specifed for both of the address prefix 
parameters, all IP filter entries for the specified network are deleted. The 
default is ALL. 

SOURCE _JP_M ASK (SIM) 

Specifies the source IP mask of the IP filter entry to be deleted. The 
keyword HOST matches an IP filter entry whose SOURCE _IP_MASK is 
HOST. The default is HOST. 

DESTINATION JIPJ6ASK (DIM) 

Specifies the destination IP mask of the IP filter entry to be deleted. The 
keyword HOST matches an IP filter entry whose DESTINATION _IP_ 
MASK is HOST. The default is HOST. 

PROTOCOL (P) 

Specifies the protocol of the IP filter entry to be deleted. The keywords 
ICMP, TCP, and UDP specify corresponding protocol values. The keyword 
ANY matches an IP filter entry whose PROTOCOL is ANY. The default is 
ANY. 
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SOURCE JPORT ^NUMBER (SPN) 

Specifies ranges of source port number values of the IP filter entry to be 
deleted. The keyword ANY matches an IP filter entry whose SOURCE _ 
PORT_NUMBER is ANY. The default is ANY. 

DESTINATION _PORT_NUMBER (DPN) 

Specifies ranges of destination port number values of the IP filter entry to 
be deleted. The keyword ANY matches an IP filter entry whose 
DESTINATION _PORT_NUMBER is ANY. The default is ANY. 

Responses The specified IP filter entry is deleted from IP network <ip_network>. 

All IP filter entries are deleted from IP network <ip_network>. 

-WARNING- No IP filter entries are defined on IP network <ip_ 
network >. 

—ERROR- IP network <ip_network> is not defined. 

-ERROR- The specified IP filter entry is not defined on IP network <ip_ 
network >. 



Examples 



del ete_ip_f liter ip_network=( 129,179,52) source_ip_address=(129, 179) 
dest1nat1on_1p_address=(129, 179,63) source_ip_mask=(255,255) .. 
destination_ip_mask=host protocol=any source_port_number=1 . .126 .. 
dest ination_port_number= 127. .255 



The specified IP filter entry is deleted from IP network 129. 179.52. 

delete_ip_f ilter ip_network=( 129, 179,52) 
All IP filter entries are deleted from IP network 129,179,63. 



delete_ip_f ilter 1p_network=( 129, 179,52) source_ip_address=(129,179) . 
destination_1p_address=( 129, 179,63) source. 1p_mask=( 255, 255) .. 
dest1nation_1p_mask=host protocol =any source_port_number=l. .126 .. 
destination_port_number=127. .255 

--ERROR— The specified IP filter entry is not defined on IP network 
129.179.52. 



delete_ip_f ilter 1p_network=( 129, 179,54) source_1p_address=(129,179) 
destination_ip_address=(129, 179,63) source_1p_mask=(255,255) .. 
dest 1 nation.! p_mask=host protocol =any source_port_number=1 . . 126 
dest 1 nat 1 on_por t .number = 1 27 . . 255 

—ERROR— IP network 129.179.54 is not defined. 
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DELETE _NON _CDC ^ADDRESS PREFIX (DELNCAP) 
NETOU Command 

Purpose Deletes a previously configured address prefix of non-CDCNET NSAP 
addresses, and information about the associated next hop. 

Format DELETE _NON _CDC _ADDRESS .PREFIX 

ADDRESS .PREFIX = list 1..10 of string 2..40 or ALL 

Parameters ADDRESS _PREFEX (AP) 

Specifies the set of address prefixes of non-CDCNET NSAP addresses 
which are to be deleted. Specify ALL if all address prefixes are to be 
deleted. Specify each address prefix in hexadecimal, and enclose each 
address prefix in single quotes. 

Responses The following response is repeated for each address prefix affected by the 
command when you specify one or more valid address prefixes. 

The NonCDCNET NSAP address prefix < address _prefix> is deleted. 

The following response is displayed if you specify ALL for the address __ 
prefix parameter. 

All NonCDCNET NSAP address prefixes are deleted. 

The following response is displayed if a requested address _prefix has not 
been configured. 

-WARNING- The NonCDCNET NSAP address prefix < address, 
prefix > is not defined. 

The following response is displayed if no NonCDCNET address .prefixes 
have been configured. 

-WARNING- No NonCDCNET NSAP address prefix is defined. 

The following response is displayed for each value of the address _prefix 
parameter which contains an odd number of digits. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains an odd number of digits. 

The following response is displayed for each value of the address .prefix 
parameter which contains a non-hexadecimal character. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains non-hexadecimal characters. 

The following response is displayed if the ES - IS routing is not defined. 

-ERROR- ES - IS routing is not defined. 
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Examples delete_non_cdc_address_pref 1x ap«'044723ff 

The NonCDCNET NSAP address prefix 044723FF Is deleted. 

delete_non_cdc_address_pref1x ap=('044723ff , '44aaeeff ) 

The NonCDCNET NSAP address prefix 044723FF 1s deleted. 
The NonCDCNET NSAP address prefix 44aaeeff Is deleted. 

delete_non_cdc_address_pref 1x ap='al 1 ' 

All NonCDCNET NSAP address prefixes are deleted. 

de 1 et e_non_cdc_addr ess_pref 1 x ap=' 044eef hh ' 

—ERROR— The NonCDCNET NSAP address prefix '044eefhh' contains 
non-hexadecimal characters. 
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DELETE _NON _CDC .ROUTING _ENTRY (DELNCRE) 
NETOU Command 

Purpose Deletes a previously configured routing entry, when executed in the same 
boundary system in which the routing entry was added, by using the 
ADD _NON_CDC .ROUTING _ENTRY command. 

Format DELETE _NON _CDC .ROUTING _ENTRY 

ADDRESS .PREFIX = list l..fo of string 2..40 or ALL 

Parameters ADDRESS .PREFIX (AP) 

Specifies the address prefix of non-CDC NSAP addresses for which the 
routing entry is to be deleted. The value ALL deletes all non-CDCNET 
NSAP addresses. The elements of each string must be hexadecimal digits. 

Responses The following response is generated if the value of the address prefix 
parameter specifies a single address prefix. 

The routing entry for the NonCDCNET NSAP address prefix 
< address .prefix > is deleted. 

The following response is generated if the value of the address prefix 
parameter specifies a list of two or more address prefixes. 

The routing entries for the following NonCDCNET NSAP address 
prefixes are deleted (see examples for list of entries deleted). 

The following response is generated if a value of ALL is specified for the 
address prefix parameter. 

Routing entries for all NonCDCNET NSAP address prefixes are deleted. 

The following response is generated if a requested address prefix has not 
been configured. 

-WARNING- A routing entry for the NonCDCNET NSAP address 
prefix < address .prefix > is not defined. 

The following response is generated if no NonCDCNET address prefixes 
have been configured. 

-WARNING- No routing entry for NonCDCNET NSAP address prefix 
is defined. 

The following response is generated for each value of the address .prefix 
parameter which contains an odd number of digits. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains an odd number of digits. 

The following response is generated for each value of the address .prefix 
parameter which contains a non-hexadecimal character. 

-ERROR- The NonCDCNET NSAP address prefix < address .prefix > 
contains non-hexadecimal characters. 
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Examples delete_non_cdc_rout1ng_entry ap='044723FF' 

The routing entry for NonCDCNET NSAP address prefix 044723FF Is deleted. 

delete_non_cdc_rout1ng_entry ap=('044723FF', '44AAEEFF') 

The routing entries for the following NonCDCNET NSAP address prefixes 

are deleted. 

044723FF 

44AAEEFF 

delete_non_cdc_routmg_entry ap='al 1 ' 

Routing entries for all NonCDCNET NSAP address prefixes are deleted. 

de l ete_non_cdc_rout 1 ng_ent ry ap= ' 044EEFHH' 

—ERROR— The NonCDCNET NSAP address prefix 044EEFHH contains 
non-hexadecimal characters. 
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DELETE ^OUTGOING .SERVICE .ACCESS (DELOSA) 
NETOU Command 

Purpose Deletes previously added titles of servers that may be accessed going out 

via the network solution. 

Format DELETE .OUTGOING .SERVICE .ACCESS 

TITLE = list 1..15 of name or string 1..255 
NETWORK NAME = name 

Parameters TITLE (T) 

Specifies a title of a server that may be accessed coming in via the 
network solution. The title must match a previously added title exactly, 
including any wildcard characters (see the CDCNET Network Operations 
and Analysis manual for more information). 

Title is case-sensitive when entered as a string. For example, a title 
entered in uppercase with the ADDOSA command must always be entered 
in uppercase on this command, or it is seen as a different title. 

NETWORK JNAME (NN) 

Identifies the name of a currently defined network within this system. This 
is the network solution upon which the accessible services are being 
defined. Default is the previously defined network when on the 
configuration file. It is required when entered by the operator. 

Responses Incoming service access deleted from network < network .name >. 

—WARNING— Incoming service access deleted from network < network __ 

name > . 

Title <title> not found. 

{Line repeats for each title not found} 

—ERROR- A network is not defined. 

—ERROR- Network < network _name> is not defined. 

—ERROR- Title < title > may not appear more than once in the list of 
specified titles. 

-ERROR- Expecting NAME or STRING, found <xxx>. 

Examples de 1 et e.out goi ng.ser v1 ce_access title-' SVL 118' net worlc_name«$NET_32 

Outgoing service access deleted from network $NET_32. 
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DELETE JRIP_SERVICE (DELRS) 
NETOU Command 

Purpose Deletes the definition of RIP (Routing Information Protocol) for a directly 

connected IP network. The network is referenced by its IP network 
number. 

Format DELETE _RIP_SER VICE 

IP_NETWORK = list 1..4 of 0..255 
REMOVE JiOUTES = boolean 

Parameters IP_NETWORK (IN) 

Specifies the IP network number of the directly connected network on 
which RIP is to be deleted. 

REMOVE _ROUTES (RR) 

Specifies whether the network routes learned by RIP on the specified D? 
network should be removed from the routing tables. The default is TRUE. 

Responses RIP service for network <ip_network> is deleted. 

-ERROR- RIP network <ip .network > is not defined. 
Examples delete_Mp_serv1ce 1p_.net work = (128,5) 

RIP service for network 128.5 1s deleted. 
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DELETE _SNMP COMMUNITY (DELSC) 
NETOU Command 

Purpose Deletes support of an SNMP community. 

Format DELETE _SNMP_COMMUNITY 

COMMUNITY = string 1..32 

IP_M>DRESS = list 1..4 of 0..255 

Parameters COMMUNITY (C) 

Specifies the community name for which support is to be deleted. 

IPJLDDRESS (IA) 

Specifies an IP address associated with the input community name. If this 
parameter is not specified, incoming PDUs with the specified community 
name are denied access. If the parameter is specified, only the entry 
related to the specific IP_jU)DRESS/COMMUNITY pair is deleted. 

Responses The SNMP community '< community >' has been deleted. 

IP address <ipaddress> for SNMP community '< community >' has been 
deleted. 

-ERROR- The SNMP Agent is not defined. 

-ERROR- The SNMP community '<community>' is not defined. 

-ERROR- IP address <ip address > for SNMP community '< community >' 
is not defined. 

Examples delete.snmp.community community*' manager 1' 

The SNMP community 'manager r has been deleted, 
delete.snmp.community community*' manager 2' ip_address=(125.3. 12.42) 

IP address 125.3.12.42 for SNMP community 'manager 2' has been deleted, 
de lete.snmp.cominun i ty commun i ty= ' test ' 

—ERROR— The SNMP Agent is not defined, 
delete.snmp.community commun ity*' community name not defined' 

— ERROR— The SNMP community 'community name not defined' is not defined, 
delete.snmp.community community* 'manager 3' ip_address=(125.3.12.42) 

—ERROR— IP address 125.3.12.42 for SNMP community 'manager 3' is not defined. 
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DELETE _TCPIP_ACCESS (DELTA) 
NETOU Command 

Purpose Deletes TCP/IP access services to a NOS/VE host. The host is referenced 
by the interface name of the channel interface previously defined for that 
host. Deleting the TCP/IP access prevents new connections for TCP/IP 
applications on the NOS/VE host from being made. Existing connections 
continue processing until terminated. 

Format DELETE _TCPIP_ACCESS 

INTERFACE _NAME = name 

Parameters INTERFACE _NAME (IN) 

Specifies the logical name of the NOS/VE interface used for the TCP/IP 
access being deleted. 

Responses TCPIP access is deleted for VE interface < interface _name>. 

-WARNING- TCP/IP access is not added for VE interface < interface 
name>. It cannot be deleted. 

—ERROR- VE interface < interface _name> is not defined. 

—ERROR- Interface name < interface _name> is not a VE channel 
interface. 

Examples delete_tcpip_access interface_name=$mci4 

TCPIP access 1s deleted for VE Interface $MCI4. 
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DELETE _TELNET ..SERVER (DELTS) 
NETOU Command 

Purpose Deletes the specified TELNET server. 

Format DELETE _TEL.NET SERVER 

SERVER _NAME = name 

Parameters SERVER _NAME (SN) 

Specifies the name of the TELNET server to be deleted. 

Responses TELNET server < server _name> is deleted. 

-ERROR- TELNET server < server _name> was not found. 
Examples delete_tel net .server server _name=arhnet 

TELNET server ARHNET is deleted. 
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DELETE _X25 _GW_INCALL (DELXGI) 
NETOU Command 

Purpose Deletes DTE addresses specified in previously entered ADD_X25_GW_ 
INCALL commands. 

Format DELETE _X25 _GW_INCALL 

REMOTE _DTE_ADDRESSES = list 1..31 of string 1..15 or 

OTHER 

GATEWAY.NAME = name 

Parameters REMOTE _DTE .ADDRESSES (RDA) 

Specifies one or more DTE addresses to be deleted from the allowed DTE 
addresses. The DTE addresses must have been specified in a previous 
ADD_X25_GW_INCALL command. The keyword OTHER may be specified. 

GATEWAY_NAME (GN) 

Specifies the name of the X.25 application-to-application gateway which 
receives the incoming calls to be validated. The gateway must have been 
previously defined. 

Responses X.25 incall deleted from gateway < gateway _name>. 

-WARNING- Remote _dte_address < string > does not exist for X.25 
gateway <name>. 

-ERROR- An X.25 gateway is not defined. 

-ERROR- X.25 gateway <name> is not defined. 

-ERROR- Remote _dte_address can not include < string >. A remote _dte_ 
address may include only digits thru 9. 

Examples The following example specifies that DTE address 4082345 is permitted to 
make incalls only to services on the CDCNET network permitted to 
'OTHER' callers, if any. 

delete_x25_gw_1ncall, gateway_name - X25GW, 
remote_dte_address ='4082345' 

X.25 incall deleted from gateway X25GW 
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DELETE _X25__GW__OUTCALL (DELXGO) 
NETOU Command 

Purpose Deletes an X.25 gateway outcall title from the specified gateway. The 

gateway must have been previously defined. 

Format DELETE _X25 _GW_OUTCALL 

TITLE = list 1..255 of name 
GATEWAY_NAME = name 

Parameters TITLE (T) 

Specifies the title that your CDNA applications can use to access a 
particular remote application through the gateway. The title supports calls 
from CDNA systems to remote systems accessed through the X.25 network. 

GATEWAYJVAME (GN) 

Specifies the name of the X.25 gateway that provides access to the remote 
application. 

Responses X.25 gateway title < title > deleted. 

-ERROR- X.25 gateway title <title> was not found. 

-ERROR— X.25 gateway <name> is not defined. 
Examples delete_x25_gw_outcal 1 t="PTFS$FOREIGN" 

X.25 gateway title ptfs$F0REIGN deleted. 
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DELETE _X25_GW PVC (DELXGP) 
NETOU Command 



Purpose 



Deletes the configuration of an X.25 gateway permanent virtual circuit 
(PVC). 

NOTE 



If there is an application connection to the PVC, the connection is not 
deleted until the X.25 Gateway receives a Session disconnect or the peer 
connection has sent a reset indication with the CAUSE field set to OUT 
OF ORDER. 



Format 



DELETE _X25 _GW_PVC 
TITLE = name 
GATEWAY_NAME = name 



Parameters TITLE (T) 

Specifies the title that applications can use to access a particular remote 
application through this gateway. The title is used to support calls from 
CDCNET systems to remote systems accessed through the X.25 trunk. The 
PVC associated with this title is deleted. 

GATEWAY_NAME (GN) 

Specifies the name of the X.25 gateway which provides access to the 
remote application. The gateway must have been previously defined. 

Responses PVC <pvc> deleted for title < title >, X.25 gateway <gw>. 

-ERROR- An X.25 gateway is not defined. 

-ERROR- X.25 gateway title < title > not found. 



| Examples delete_x25_gw_pvc t1tle=PVC$FRN gateway_name=x25_gw 



PVC <100> deleted for title PVC$FRN, X.25 gateway x25_gw. 
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DELETE _X25_INCALL (DELXI) 
NETOU Command 

Purpose Deletes configured X.25 incall definition entries (added by using the ADD_ 

X25_INCALL command) for one or more trunk names and one or more 
remote DTE addresses. 

Format DELETE _X25 _INCALL 

TRUNK JIAME = list 1..32 of name 

REMOTE JOTE ^ADDRESSES = list 1..31 of string 1..31 

Parameters TRUNK_NAME (TN) 

Specifies the set of trunks associated with the X.25 incall definition entries 
to be deleted. The value ALL is used to delete the specified entries 
associated with the remote DTE addresses on all trunks previously 
configured with X.25 incall definition entries. The default is ALL. 

REMOTE _DTE .ADDRESSES (RDA) 

Specifies the set of remote DTE addresses associated with the X.25 incall 
definition entries to be deleted. Wild card attributes (as specified by 
command ADD_X25_INCALL) must exactly match an entry as specified 
by ADD_X25_INCALL. For example, a value of '123*' matches only on 
entry '123*'. It does not match all entries with '123' as the first three 
digits. If a REMOTE _DTE .ADDRESSES value has multiple entries 
associated with it (due to different values of DTE_ADDRESS_ 
PROTOCOLED), all of those entries are deleted. The value OTHER 
corresponds to any entries defined with the value OTHER. The value ALL 
is used to delete all X.25 incall definition entries for the trunks specified. 
The default is ALL. 

Responses The response for each trunk is shown separately. 

The following response is generated if the value of the remote DTE address 
parameter specifies a remote DTE address: 

The X.25 incall definition entry for trunk <trunk_name> for the 
remote DTE address < remote _dte_address> is deleted. 

The following response is generated if the value of the remote DTE address 
parameter specifies a list of two or more remote DTE addresses: 

The X.25 incall definition entries for trunk < trunk _name> for the 

following remote DTE addresses are deleted. 

{The above line is followed by a list of address prefixes. Please see the 

command response example for the format in which this information is 

displayed.} 

The following response is generated if a value of ALL is specified for the 
remote DTE address: 

X.25 incall definition entries for trunk < trunk _name> for all remote 
DTE addresses are deleted. 
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The following response is generated if no X.25 incall definition entry has 
been configured, regardless of input errors: 

-WARNING- No X.25 incall definition entry for any trunk is defined. 

The following response is generated if X.25 incall definition entries have 
been configured, but none were explicitly specified for a trunk: 

-WARNING- No X.25 incall definition entry for trunk < trunk _name> 
is defined. 

Error responses: 

-ERROR- An X.25 incall definition entry for the remote DTE address 
< remote _dte_address> is not defined for trunk < trunk _name>. 

—ERROR— Trunk name < trunk _name> is not defined. 

-ERROR— Trunk name <trunk_name> is not an X.25 trunk. 

—ERROR— Trunk name < trunk _name> may not appear more than 
once in the list of specified trunks. 

—ERROR— Remote DTE address < remote _dte_address> may not 
appear more than once in the list of specified remote DTE addresses. 

-ERROR- The remote DTE address < remote _dte_address> contains 
invalid characters. 

-ERROR— The remote DTE address < remote _dte_address> has an 
invalid bracketed expression. 

-FATAL- Not enough memory available for required table space. 

Examples delete_x25_1ncall remote_dte_address= 12345 

The X.25 Incall definition entry for trunk X25_TRUNK 
for remote DTE address 12345 Is deleted. 

delete_x25_incal1 remote_dte_address=C 12345678', '87654321') 

The X.25 Incall definition entries for trunk X25.TRUNK 
for the following remote DTE addresses are deleted. 

12345678 
87654321 

delete_x25_1ncall 

X.25 incall definition entries for trunk X25_TRUNK 
for all remote DTE addresses are deleted. 

de1ete_x25_1ncal 1 trunk_name=ACCUNET 

No X.25 Incall definition entry for trunk ACCUNET is defined. 
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DELETE Jt26JSWITCH (DELXS) 



DELETE _X25 .SWITCH (DELXS) 

Purpose Allows an operator to delete X.25 switch definition entries previously added 
using the ADD_X25_SWITCH command. Deleting a switch definition does 
not affect existing connections. 

Format DELETE _X25 ..SWITCH 

GATEWAY J^AME = list 1..32 of name or ALL 
CALLED J)TE ^ADDRESSES = list 1. .31 of string 1..31 or keyword 
value 



Parameters GATEWAY _NAME (GN) 

Specifies a set of X.25 Gateways associated with the X.25 switch definition 
entries to be deleted. Use ALL to delete the specified entries associated 
with the CALLED_DTE .ADDRESSES on all X.25 Gateways previously 
configured with X.25 switch definition entries. The default is ALL. 

CALLED JiTE .ADDRESSES (CD A) 

Specifies one or more called DTE addresses. A DTE address can contain 
wild card attributes (to associate the switch definition with multiple DTE 
addresses) as follows: 

[D1-D2] Within a bracketed group, a range of digits can be specified. Dl 
represents the low end of the range; D2 represents the high end. 
Any value within the range can be used to match a digit in the 
position specified in the address. For example, 1234[6-7]59 
matches two DTE addresses: 1234659 and 1234759. 

[...] Within a bracketed group, any list of single digits can be 

specified. For example, 1234[179]59 matches three DTE 
addresses: 1234159, 1234759, and 1234959. 

* Any single * can be used to match a string of digits, including 

the null string. For example, 1234* matches 1234, 12341, 
1234562345, and so forth. 

? Any single ? can be used to match a digit in the position 

specified in the address. For example, 1234759 matches 10 DTE 
addresses: 1234059, 1234159, 1234259 ... 1234959. 

If multiple ADD_X25 ..SWITCH definitions match a given DTE address, 
the call definition associated with the most specific string is deleted. For 
example, 123756 is more specific than 123* in matching called DTE 
address 123456. 

The value OTHER corresponds to any entries defined with the value 
OTHER. The value ALL deletes all X.25 switch definition entries for the 
X.25 Gateways specified. The default is ALL. 
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DELBTE_X25 .SWITCH (DBLXS) 



Responses (The response for each X.25 Gateway is shown separately.) 

The following response is generated if the value of the called DTE address 
parameter specifies a called DTE address: 

The X.25 switch definition entry for X.25 Gateway < gateway _name> 
for the called DTE address < called _dte_address> is deleted. 

The following response is generated if the value of the called DTE address 
parameter specifies a list of two or more called DTE addresses: 

The X.25 switch definition entries for X.25 Gateway < gateway _name> 
for the following called DTE addresses are deleted. 

< called _dte _address > 

The following response is generated if a value of ALL is specified for the 
called DTE address: 

X.25 switch definition entries for X.25 gateway < gateway _name> for 
all called DTE addresses are deleted. 

The following response is generated if no X.25 switch is defined, regardless 
of input errors: 

-WARNING-- No X.25 switch definition entry for any X.25 Gateway is 
defined. 

The following response is generated if an X.25 switch is defined, but none 
explicitly for an X.25 Gateway: 

-WARNING- No X.25 switch definition entry for X.25 Gateway 

< gateway _name> is defined. 

The following error responses are generated upon an error condition: 

-ERROR- An X.25 switch definition entry for the called DTE address 
< called _dte_address> is not defined for X.25 Gateway <gateway_ 
name>. 

-ERROR- X.25 Gateway < gateway _name> is not defined. 

-ERROR- X.25 Gateway < gateway _name> may not appear more than 
once in the list of specified X.25 Gateways. 

-ERROR- Called DTE address < called _dte_address> may not appear 
more than once in the list of specified called DTE addresses. 

-ERROR- The called DTE address < called _dte_address> contains 
invalid characters. 

-ERROR- The called DTE address < called _dte_address> has an 
invalid bracketed expression. 

-FATAL— Not enough memory available for required table space. 
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DELETE Jt25J3WITCH (DELXS) 



Examples delete_x25_sw1tch ca 11 ed_dte_address= 12345 

The X.25 switch definition entry for X.25 Gateway X25_GW_SWITCH 
for called DTE address 12345 is deleted. 

de1ete_x25_sw1tch cal led_dte_address=(' 12345678' , '87654321') 

The X.25 switch definition entries for X.25 Gateway X25_GW_SWITCH for 
the following remote DTE addresses are deleted. 

12345678 
87654321 

delete_x25_sw1tch 

X.25 switch definition entries for X.25 Gateway X25_GW_SWITCH 
for all called DTE addresses are deleted. 



del ete_x25_swi tch gateway_name=X25_SWITCH 

No X.25 switch definition entry for X.25 Gateway X25_SWITCH is 
defined. 
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DELETE _X25_TERMINAL_GW_OUTCALLS (DELXTGO) 

DELETE _X25 .TERMINAL _GW__OUTCALLS (DELXTGO) 
NETOU Command 

Parameters Deletes the configuration of an X.25 terminal gateway outcall(s). 

Format DELETE _X25 .TERMINAL .GW.OUTCALLS 

OUTC ALL .NAME = name or ALL 
GATEWAY.NAME = name 

Parameters OUTCALL .NAME (ON) 

Specifies either the outcall name entered on the ADDXTGO command that 
corresponds to all X.25 outcall block definitions, or ALL. 

GATEWAY.NAME (GN) 

Specifies the name of the X.25 terminal gateway which provides access to 
the remote application. The gateway must be previously defined. 

Responses X.25 terminal gateway outcall < outcall _name> is deleted. 

X.25 terminal gateway outcalls are deleted. 

—ERROR— X.25 terminal gateway outcall < outcall _name> was not found. 

—ERROR— X.25 terminal gateway <name> is not defined. 
Examples de1ete_x25_terminal_gw_outcal Is on=S0LVER1 gn-all 

X.25 terminal gateway outcall S0LVER1 1s deleted. 

delete_x25_term1nal_gw_outcalls on=ALL gn=all 

X.25 terminal gateway outcalls are deleted. 
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DISPLAY Commands 8 

This chapter provides complete descriptions of all CDCNET Network Operations 
DISPLAY commands. Command descriptions are organized alphabetically by full 
command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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DISPLAY_CHANNEL_CONNECT_STATUS (DISCCS) 



DISPLAY_CHANNEL .CONNECT STATUS (DISCCS) 
NETOU Command 



Purpose 



Format 



Parameters 



Responses 



Displays the operating status of the channel connection entity (CCE), the 
specific service access points (SAPs), and the specific connections serviced 
by the channel connection entity. Displayed information includes identifying 
the SAPs and their connections by their SAP names, local reference 
number and CEPID (Connection End Point Identifier). 

Connection identifiers are unique for all connections assigned by CCE. 
Channel connection entity status displays are described following the 
command examples. 

DISPLAY_CHANNEL .CONNECT STATUS 
DISPLAY JOPTION = keyword value 

DISPLAY JOPTION (DO) 

Displays the level of status response. The allowed keyword values are: 

Keyword Value Description 

SUMMARY (S) 



EXPANDED (E) 



Provides a summary status display of channel 
connect information per interface. 

Provides an expanded status display of channel 
connect information per interface. 



Default is SUMMARY. 

The following header precedes the options display (see examples). 

Channel Connection Status. 

Within the status display, the following response is inserted if the SAP is 
open and has no connections established. 

No connections established for this SAP. 
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DISPLAY_CHANNEL_CONNECT_S'EA.TUS (DISCCS) 



Examples d 1 sp 1 ay.channe 1 .connect _st at us 

Channel Connection Status 

Interface name ■ MCI_5 

device name = $MCI5 

link status = UP 

date and time Interface last became active = 89/03/13 08.04.01 

open SAPs ■ TAP SMAP 

number of connections ■ 5 

number of connections to host congested ■ 1 

number of connections user Initiated stop = 1 

Interface name = MCI_7 

device name = $MCI7 

link status = UP 

date and time interface last became active = 89/03/13 08.04.01 

open SAPs = TAP SMAP 

number of connections = 

number of connections to host congested = 

number of connections user initiated stop = 



d1splay_channel_connect_status display_option=e 

Channel Connection Status 

interface name ■ MCI_5 

SAP name ■ TAP 

Local CEPID User Peer/Local Connection Connection 

Ref # CEPID Credits Priority State 

0001(16) 001068A0 001056AO 4/5 Priority Active 

0002(16) 001069FO 00106890 6/2 Normal Disconnecting 

0003(16) 00106BEO 00107056 3/1 Normal Congested 



SAP name ■ SMAP 

Local CEPID User Peer /Local Connection Connection 

Ref # CEPID Credits Priority State 

0005(16) 00105DCO 00000000 16/0 Normal Con req recvd 



0018(16) 001053A0 00106290 



3/5 



Normal 



User stopped 



Interface name * MCI_7 

SAP name ■ TAP 
No connections established for this SAP 
SAP name - SMAP 
No connections established for this SAP 
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DISPLAY_CHANNEL_CONNECT_STATUS (DISCCS) 

Channel Connect Display Description 

The summary status display information includes: 

• Interface name 

• Device name 

• Link status 

• Date and time interface last became active 

• Open SAPs 

• Number of connections 

• Number of connections to host congested 

• Number of connections user initiated stop 

The expanded connection display information includes: 

• Interface name 

• For each SAP that is open: 

Local reference number for each connection associated with the given SAP 
CEPID (Connection Endpoint Identifier) 
User CEPID 

• Peer allocated credits per connection 

• Local allocated credits per connection 

• Connection priority 

• State of the connections as follows 

Idle - no data sent or received in the last 5 minutes 

Congested - window to host closed 

User stopped - CC user issued a stop on the connection 

Active - normal or expedited data sent/received in the last 5 minutes 

Con req sent - a connection request has been sent for the connection 

Con req recvd - a connection request has been received - awaiting accept or 
reject from the user 

Disconnecting - the connection is being disconnected 
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DISPLAY_CLNS_FILTER (DISCP) 



DISPLAY_CLNS_FILTER (DISCF) 
NETOU Command 

Purpose Displays previously configured CLNS filter entries for a specified network 

or all networks. 

Format DISPLAY_CLNS .FILTER 

NETWORK _NAME = name or ALL 

Parameters NETWORKJSfAME (NN) 

Identifies the name of a currently defined network within this system or 
all networks. If a name is specified, CLNS filter entries for the network 
named are displayed. If the keyword ALL is specified, CLNS filter entries 
from all networks are displayed. The default is ALL. 

Responses All CLNS filter entries for the specified network (or all networks) are 
displayed. The source and destination address prefixes and the access 
allowed values are shown for each entry. The display is ordered the same 
as used during CLNS filter processing (longer address prefixes first). 

The following response is generated if no CLNS filter is defined for the 
specified network, regardless of input errors: 

No CLNS filter entries are defined for network < network _name>. 

—ERROR— Network < network _name> is not defined. 

Examples d1splay_clns_f i Iter network_name=NETW0RK1 

CLNS Filter Entries for network NETW0RK1: 



Allowed 


Source NSAP Prefix 


FALSE 


080027 1000EE334567 


TRUE 


080027 1000EE33 


TRUE 


080027100088 


FALSE 


any 



Destination NSAP Prefix 

00470008400 1BC56 
00470008400 1BC56 
any 

004700084003A142000000000000 . 
..0056 



d1splay_dns_f 1 1ter network_name=NETW0RK1 
No CLNS filter entries are defined for network <network_name>. 

d1splay_clns_f 1 1ter network_name=NETWORK2 
—ERROR— Network NETW0RK2 Is not defined. 



fiftOOOdld F 



ntfiDT 4V ft, 
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DISPLAY_CLNS_OPTIONS (DISCO) 



DISPLAY_CLNS ..OPTIONS (DISCO) 
NETOU Command 

Purpose Displays the current value of connectionless mode network service (CLNS) 
options. These values are either the CDCNET default values or the values 
specified by the CHANGE _CLNS command. 

Format DISPLAY_CLNS .OPTIONS 

DISPLAY JOPTION = list 1..3 of keyword value 

Parameters DISPLAY JOPTION (DO) 

Displays one or more of the CLNS attributes. The allowed keyword values 



are: 



Keyword Value 



Description 



HEADER_CHECKSUM 
(HC) 



DERIVED _PDU_ 
RETENTION _TIME 
(DPRT) 

PDU .MAXIMUM _ 
LIFETIME (PML) 



ALL (A) 
Default is ALL. 



Determines whether the connectionless mode 
network service (CLNS) entity is to calculate a 
checksum for the header on an outgoing initial 
PDU. 

Displays the time (in seconds) the DI retains 
any derived PDUs it receives that do not form a 
complete initial PDU. 

Displays the maximum number of hops a 
network PDU can traverse. If a network PDU 
traverses more than the number of hops 
specified by the PML parameter, the PDU is 
discarded and an error PDU is sent back to the 
originator of the PDU. The error PDU states 
that the lifetime was exceeded. 

All of the specified keyword values. 



Responses The 

CLNS options 
Examples d 1 sp 1 ay_c 1 ns.opt 1 ons 



following header precedes the options display (see examples). 



CLNS options 

header .checksum ■ FALSE 

derlved_pdu_retention_tlme =10 
Pdu_max1mum_ltfet1me ■ 64 
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DISPLAYjCOMMAND INFORMATION (DISCI) 



DISPLAY_COMMAND .INFORMATION (DISCI) 
NETOU Command 

Purpose Displays parameter information of the specified command. The specified 

command must be one of the available network commands. The information 
includes parameter names, types, and their default values. 

Format DISPLAY_COMMAND .INFORMATION 

COMMAND = name 

Parameters COMMAND (C) 

Displays the parameters of specified command. You must provide either the 
full name or the command abbreviation. The specified command must be a 
network command. 

Responses List of parameter names, parameter abbreviations, and parameter syntax 
for the specified command (see example). 

-ERROR- < string > is not a command. 

-FATAL-The command information for the command, < string > cannot be 
processed. 

Remarks As seen in the example, the format of the parameter information displayed 
by the DISCI command may differ from what appears in this manual for 
the same commands example. The manual text presents the parameter 
format of the CHANGE _PASSTHROUGH .STATUS command (when 
specified on the DISCI command) as follows: 

INACTIVITY_TIMER = 120..14400 or keyword 

The DISCI display usually provides the TYPE information, the permissable 
range if the parameter is an INTEGER type, and the permissable keyword 
values of each parameter. 

Examples d1 spl ay_command_1 nf ormat 1 on command=change_passt hrough_stat us 



FROM DI_100085_SL 
1nact1vity_t1mer, It: Integer 120. 



34233 
,14400 op key Infinite 



Infinite 
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DISPIAY_COMMAND_LIST (DISCL) 

DISPLAY J30MMANDJLIST (DISCL) 
NETOU Command 

Purpose Displays a list of network commands for which you are validated. The 

commands are arranged in alphabetical order. Only the long form of the 
command is returned. The HELP and DISPLAY_COMMAND_LIST_ 
ENTRY commands are aliases for this command. 

Format DISPLAY_COMMAND _LIST 

Parameters None. 

Responses Alphabetical list of network commands (see example). 

Examples dl sp 1 ay_command_ list 



add_arp_reported_.net s 



add_egp_reported_nets 



unload_module 



write_terminal_message 



60000414 C 



DISPLAY Commands 8-7 



DISPLAY_COMMAND JLIST_ENTRY (DISCLE) 

DISPLAY.COMMAND _LIST JENTRY (DISCLE) 
NETOU Command 

Purpose The DISPLAY_COMMAND_LIST_ENTRY command is an alias of the 

DISPLAY_COMMAND_LIST command. Like DISPLAY_COMMAND_LIST, 
this command displays an alphabetical list of network commands. 

Format DISPLAY_COMMAND _LIST_ENTRY 

Parameters None. 

Responses Alphabetical list of network commands (see example). 

Examples d i sp 1 ay_comtiand_ 1 i st _ent ry 

add_ar p_repor t ed_net s add_egp_r epor t ed_net s 



un 1 oadjnodu 1 e writ e_t erml na 1 .message 
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DISPLAY_CONS JNCALL (DISCIC) 



DISPLAY_CONS_INCALL (DISCIC) 
NETOU Command 

Purpose Displays previously configured CONS incall definition entries for one or 

more NSAP address prefixes. 

Format DISPLAY.CONS .INCALL 

ADDRESS PREFIX = list 1..10 of string 2..40 

Parameters ADDRESS J?REFIX (AP) 

Specifies the set of NSAP address prefixes associated with the CONS incall 
definition entries to display. The elements of each string defining an 
address prefix must be hexadecimal digits, unless you specify ALL. Use the 
value ALL to display ail previously configured incall definition entries. The 
default is ALL. 



Responses For each requested address prefix for which a CONS incall definition entry 
has been configured, the configurable parameters are displayed. All entries 
with the same parameter settings are grouped together. For the format of 
this display, see the example. 

The following response is generated if no CONS incall definition entry has 
been configured, regardless of input errors: 

No CONS incall definition entry for any NSAP address is defined. 

The following response is generated if a CONS incall definition entry has 
not been configured for the requested address prefix: 

-ERROR- A CONS incall definition entry for the NSAP address prefix 
< address _prefix> is not defined. 

The following response is generated if an ADDRESS .PREFIX parameter 
contains a nonhexadecimal character: 



-ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 

The following response is generated if an ADDRESS .PREFIX parameter 
contains an odd number of digits: 

-ERROR- The NSAP address prefix < address .prefix > contains an odd 
number of digits. 

Responses The abbreviation for this command does not follow the convention. 
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DISPLAYjCONS JNCALL (DISCIC) 

I Examples display .cons.incali 

1 

| CONS Incall Definition Entries: 



NSAP address prefix 0800Z71000EE334567 

0047000B4001BC56 

O8E345F10A 
Accept PDN charges FALSE 

NSAP address prefix 394455 

004700084001BC5688 
Accept PDN charges TRUE 

display jsons.incal 1 address_pref ix='00AGEF' 

—ERROR— The NSAP address prefix OOAGEF contains non-hexadecimal characters. 

display.cons.mcall address_pref ix»'00AC0F' 

—ERROR— A CONS mcall definition entry for the NSAP address prefix 00AC0F is not defined. 
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DISPLAY_CONS_OUTCALL (DISCOC) 



DISPLAY_CONS_OUTCALL (DISCOC) 
NETOU Command 



Purpose Displays previously configured CONS outcall definition entries for one or 

more NSAP address prefixes. 

Format DISPLAY_CONS _OUTCALL 

ADDRESS _J>REFIX = list 1..10 of string 2. .40 

Parameters ADDRESS PREFIX (AP) 

Specifies the set of NSAP address prefixes associated with the CONS 
outcall definition entries to display. The elements of each string defining 
an address prefix must be hexadecimal digits, unless you specify ALL. Use 
the value ALL to display all previously configured outcall definition 
entries. The default is ALL. 

Responses For each requested address prefix for which a CONS outcall definition 

entry has been configured, the configurable parameters are displayed. All 
entries with the same parameter settings are grouped together. For the 
format of this display, see the example. 

The following response is generated if no CONS outcall definition entry 
has been configured, regardless of input errors: 

No CONS outcall definition entry for any NSAP address is defined. 

The following response is generated if a CONS outcall definition entry has 
not been configured for the requested address prefix: 

-ERROR- A CONS outcall definition entry for the NSAP address 
prefix < address _prefix> is not defined. 

The following response is generated if an ADDRESS _PREFIX parameter 
contains a nonhexadecimal character: 

-ERROR- The NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 

The following response is generated if an ADDRESS _PREFIX parameter 
contains an odd number of digits: 

-ERROR- The NSAP address prefix < address _prefix> contains an odd 
number of digits. 

Responses The abbreviation for this command does not follow the convention. 
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DISPLAY_CONS_OUTCALL (DISCOC) 



Examples display.cons.outcaii 

CONS Outeall Definition Entries: 



NSAP address prefix 

Remote DTE address 
Local DTE address 
Add reverse charging 
Add fast select 
Interface standard 
X.25 facilities 
Local non-X.25 facilities 
Remote non-x.25 facilities 
CCITT DTE facilities 
User Data 

NSAP address prefix 

Remote DTE address 
Local DTE address 
Add reverse charging 
Add fast select 
Interface standard 
X.25 facilities 
Local non-X.25 facilities 
Remote non-X.25 facilities 
CCITT DTE facilities 
User Data 

display.cons.outcaii address_pref 1x='O0AGEF' 

—ERROR— The NSAP address prefix OOABEF contains non-hexadecimal characters. 

display.eons.outcal 1 address_pref 1x='00AC0F' 

—ERROR— CONS outeall definition entry for the NSAP address prefix 00AC0F is not defined. 



080027 1000EE334567 

00470008400 1BC56 

082345F10A 

None specified 

0123456789012 

TRUE 

FALSE 

SAME.AS. INTERFACE 

None specified 
None specified 
None specified 
None specified 
CONS user specified 

394455 

004700084001BC5688 

0987654321012 

None specified 

FALSE 

TRUE 

SAME.AS. INTERFACE 

None specified 

None specified 

66778899 

None specified 

03010100 
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DISPLAY_.CONS_1980.Jt25 .MAPPING (DISC1XM) 

DISPLAY__CONS _1980 _X25 ^MAPPING (DISC1XM) 
NETOU Command 

Purpose Displays one or more previously configured NSAP addresses used to route 

incoming CONS/TPO traffic received from a 1980 X.25 PDN. This command 
displays routing information that was previously added via the ADD_ 
CONS _1980_X25 .MAPPING command. 

Format DISPLAY.CONS .1980 _X25 .MAPPING 

Parameters None. 

Responses The following header precedes the routing information. 

CONS 1980 X.25 routing information (the following is repeated for each 
entry): 

Destination NSAP address = < destination _nsap_address> 
Destination DTE address = < destination _dte .address > 
Source NSAP address = < source _nsap .address > 
Source DTE address = < source _dte .address > 

The following header occurs if no routing information exists. 

No CONS 1980 X.25 routing information exists. 

Examples di splay_cons_l980_x25_mapping 

CONS 1980 X.25 routing Information: 

Destination NSAP address - 39840f01bb7b0000000000000 1080025 10008401 
Destination DTE address » 1234567 

Source NSAP address = 39840f01bb7b00000000000001080025l0007201 
Source DTE address = 789012 



d 1 sp 1 ay_cons_ 1 980_x25_tnapp 1 ng 

CONS 1980 X.25 routing Information: 

1 
Destination NSAP address = 39840f01bb7b0000000000000 1080025 10008401 
Destination DTE address - Not Specified 

Source NSAP address - 39840f01bb7b0000000000000108002510007201 
Source DTE address - Not Specified 



disclxm 
No CONS 1980 X.25 routing information exists. 
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DISPLAY_DATE _AND JTIME (DISDAT) 
NETOU Command 

Purpose Displays the current date and time that is maintained by the DIs to which 
you send this command. 

Format DISPLAY_DATE _AND _TIME 

DATE_FORMAT = keyword value 
TIMEJFORMAT = keyword value 

Parameters DATE _FORMAT (DF) 

Specifies how date information is to be displayed. Allowed keyword values 
include the following, using as an example a date of November 1, 1986, 
and dd for day, mm for month, and yy for year. 

Keyword Value Description 



MDY Date formatted as mm/dd/yy, as in 11/01/86. 

DMY Date formatted as dd/mm/yy, as in 01/11/86. 

ISO Date formatted as yyyy-mm-dd, as in 1986-11-01. 
Default is DMY. 

TIME .FORMAT (TF) 

Specifies how time information is to be displayed. Allowed keyword values 
include the following, using as an example a time of 2:41 PM, and hh for 
hour, mm for minute, ss for second, and XX for AM or PM identifier. 

Keyword Value Description 



AMPM Time formatted as hh:mm XX, as in 2:41 PM. 

HMS Time formatted as hh:mm:ss, as in 14:41:38. 

Default is HMS. 

Responses The following header precedes the date and time in selected format (see 
example). 

System date and time 

Examples display_date_and_t1me 

System date and time 
14/10/66 15:09:24 

dl sp1ay_date_and_t 1me df =mdy. t f =ampm 

System date and time 

02/20/86 10:36 AM. 
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DISPLAY .DEVICE _OUTCALL .STATUS (DISDOS) 
NETOU Command 

Purpose Displays the current status of the Device Outcall Service. 
NOTE 



In future releases, this command will no longer be supported. You should 
start using the DISPLAY_OUTCALL_GATEWAY_STATUS command as 
soon as possible. 

Format DISPLAY JDEVICE .OUTCALL _STATUS 

Parameters None. 

Responses Device Outcall Service defined and started. 

Device Outcall Service not defined. 
Examples d 1 sp l ay_dev 1 ce.out ca 1 1 _st at us 

Device Outcall Service defined and started. 
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DISPLAY__DIRECTORY_STATUS (DISDS) 
NETOU Command 



Purpose 



Format 



Displays the operating status of the Directory Management Entity (ME) in 
a DI. The command supports summary, expanded, and detail displays. 

DISPLAY_DIRECTORY_STATUS 

DISPLAY _OPTION = list 1..3 of keyword value 
TITLE = list 1..15 of string or ALL 



Parameters DISPLAY jOPTION (DO) 

Selects the level of status for the directory status display. The following 
keyword values are allowed. 



Remarks 



Keyword Value 



Description 



SUMMARY (S) 
EXPANDED (E) 

DETAIL (D) 

ALL (A) 

Default is SUMMARY. 



Selects the summary display. 

Selects the expanded display. See the status 
display description following the examples for 
more information. 

Selects the detail display. See the status display 
description following the examples for more 
information. 

Selects all displays. 



TITLE (T) 

A list of one or more titles for which expanded or detailed information is 
desired. Enter the title as a string value within apostrophes (') (see 
examples). This parameter is meaningful only if you choose an expanded or 
detail display with the DISPLAY_OPTION parameter. If you select a 
summary display, this parameter is ignored. Default is ALL. 

Responses The following header precedes the directory status display (see example). 
Directory Status 

If a specified title is not registered, the following response is inserted in 
the status display: 



Title <name> is not registered. 

For more information on Directory Management Entity, see the Systems 
Programmer's Reference manual, Volume 2, Network Management Entities 
and Layer Interfaces. 
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Examples d1splay_d1rectory_status 

Directory Status 

current registered titles » 4 
current received titles ■ 25 
current translation requests - 8 

d1splay_d1rectory_status do=e t=''$I_L0G_ME_L0G_GR0UP_1". . 

Directory Status 

title » $I_LOG_ME_L0G_GR0UP_1 

address = 0000 1ACB080Q251 000930 1BC 

priority = 3 

registered by: TDI.AVCD 85/11/14 02:15:32 

d1splay_directory_status do=e t="TIMESHARING",mdi1 

Directory Status 

title = TIMESHARING 

address « 0000 1ACB0800251 000930 1BC 

priority = 3 

registered by: CYBER 180 SN312, MODEL82 85/11/14 02:15:32 

dlsplay.dlrectory.status do=e t="$I_L0G_ME_LOG_GROUP_2", . . 
system=md1 1 

Directory Status 

title = $I_L0G_ME_L0G_GR0UP_1 

address = 0000 1ACB0800251 000930 1BC 

priority = 3 

registered by: $DI_080025011312 85/11/14 02:15:32 

dlsplay.dlrectory.status do=d t="$I_L0G_ME_L0G_GR0UP_1", . . 
system=md1 1 

Directory Status 

title = $I_L0G_ME_L0G_GR0UP_1 
user.info ■ 

address = 00001ACB08002510009301BC 
priority ■ 3 

service = GENERIC_TRANSP0RT/0SI TRANSPORT 
translatlon.domain = CATENET 
Class = INTERNAL 
dlrld - 00001ACB080025100093851 1140215321920 
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Directory Status Display Description 

The DISPLAY_DIRECTORY_STATUS command supports summary, expanded, and 
detail displays. 

The summary display returns the following information. 

Current number of titles registered by the system 

Current number of titles received from other systems 

Number of active title translation requests for the system 
The expanded display returns the following information for each title displayed. 

Title 

Address 

Title priority 

System that registered the title 

Date and time of registration 

The detail display returns the following for each title displayed. This information is 
derived from the directory registration control block and the Directory ID for each title. 

title The title for which information is displayed. 

user. Info Information saved by the title registrator. 

address The title's network, system, service access point (SAP), entry 

point, or procedure address. 

priority Hierarchical priority level assigned to duplicates of a title. 

Priority is established by the registrator of the title. 
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service The layer connection service used by the registrator of the title. 

Services defined include the following: 

CDC .DEFINED _XXX 

CUSTOMER _DEFINED_XXX 

OSI.CLNS 

OSI .SESSION 

OSI _NON _CDNA_SESSION 

OSI .PRESENTATION 

OSI _NON _CDNA .PRESENTATION 

OSI .TRANSPORT 

SESSION 

UNKNOWN 

VIRTUAL .TERMINAL 

translation.domain Where the title may be translated. Possible values include 
CATENET or LOCAL .SYSTEM. 

class EXTERNAL, visible to CDCNET users, or INTERNAL, hidden 

from CDCNET users. 

dirid System name where the title was registered, plus the date and 

time it was registered. 
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DISPLAY.DI .SYSTEM .STATUS (DISDSS) 
NETOU Command 



Purpose 



Format 



Parameters 



Remarks 



Returns general information about the operation of a DI and resource 
usage in the DI, such as date and time of the last reload, version of load 
file used, states of buffers and memory, and CPU usage. An expanded 
status display also includes the responses to the DISPLAY HARDWARE _ 
STATUS, DISPLAY_LINE .STATUS, and DISPLAY.NETWORK .STATUS* 
commands. 

DISPLAY.DI .SYSTEM .STATUS 

DISPLAY _OPTION = keyword value 

DISPLAY JOPTION (DO) 

Selects a summary or expanded status response. There are two possible 
values for this parameter. 



Keyword Value 



Description 



SUMMARY (S) 



EXPANDED (E) 



Selects general DI operating system status and 
does not include the additional hardware, line, 
and network status displays. 

Selects general system status and status for the 
hardware component(s) in the DI. The hardware 
display is a combination of the hardware status, 
line status, and network status displays, and is 
appended to the end of the summary display. 



Default is SUMMARY. 



Responses The following header precedes the DI system status display (see example). 

rvr o i. en-i. 



DI System Status 



A DI containing an MPB-II board cannot contain a PMM board. Instead, 
the MPB-II RAM is treated as if it were PMM. The DISDSS display gives 
information on the PMM status, but the memory reflected is actually 
MPB-II. 
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Examples In this example, the DISPLAY_DI .SYSTEM .STATUS command is entered, 
omitting the DISPLAY_OPTION parameter. The command returns a 
summary status response. 

di spl ay_di_system_status 

DI System Status 

system name = MTI_83 

system address = 080025100083(16) 

boot version number « 1511(16) 

software release level ■ 1511(16) 

number of tasks = 64 

free SMM memory = 445490 

percent CPU utilization = 4 

buffer state = good 

memory state « good 

date and time of last reload = 86/04/27 11:23:45 



Buffer Status 
type total buffers 

data 4216 

descriptor 1436 



available buffers 

3820 

1394 



buffer size 

144 

32 



SMM Memory Status 

total memory available memory extents 

1572864 279752 55 



de loadable memory 
119816 



PMM Memory Status 

total memory available memory extents 

131072 31500 9 



de loadable memory 




MPB RAM Status 

total memory available memory extents 
16384 1902 1 

Largest SMM memory extent available = 71602 



de loadable memory 
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DI System Status Display Description 

The DI System Status Display includes general DI operating system information, buffer 
and memory usage status and, optional hardware, line, and network status displays. 
For descriptions of the hardware, line, and network status displays, see the commands 
that generate those status displays. 

The general DI information section includes: 



system name 
system address 
boot version number 

software release level 



number of tasks 
free SMM memory 

free PMM memory 

percent CPU utilization 

buffer state 



memory state 



date and time of last 
reload 



The DI's name, assigned during configuration. 

The DI's unique address. 

Version number of the boot file currently loaded in 
and running on the DI. Taken from exception list or 
INITMDI. 

Version number of the compiled software currently 
loaded in and running on the DI. This value is 
defined in a common deck and indicates the released 
version level. 

Number of tasks that can run on this system. 

Amount of memory on the SMM board that is not 
currently assigned to a software process. 

Amount of memory on the PMM board that is not 
currently assigned to a software process. 

Percentage of time the CPU on the MPB board is 
performing work as opposed to being idle. 

Describes level of buffer availability. The four states 
of buffer availability are GOOD, FAIR, POOR and 
CONGESTED. See the BUFFER .BOUNDARY. 
PERCENTAGES parameter in the DEFINE .SYSTEM 
command description. Each boundary is expressed as a 
percentage of total resources allocated after the DI is 
configured. 

Describes level of memory availability. The four levels 
of memory availability are GOOD, FAIR, POOR, and 
CONGESTED. See the MEMORY_BOUNDARY_ 
PERCENTAGES parameter in the DEFINE .SYSTEM 
command description. Each boundary is expressed as a 
percentage of total resources allocated after the DI is 
configured. 

The time when the DI software was last reloaded. 
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Buffer Status 



Displays the following information: 
Total Buffers 



Available Buffers 



Buffer Size 



The total number of buffers 
allocated for use by the DI. 

The number of allocated 
numbers that are now currently 
in use. 

The size, in bytes, of a 
particular buffer. 



Memory Status (PMM, SMM, mpb) Displays the following information: 



The total number of bytes of 
memory for this DI. 

The total number of bytes of 
memory available for loading 
modules and allocating 
structures by these modules. 

The number of memory extents 
into which available memory is 
divided. 

The number of bytes that can 
be used when a deloadable 
threshold is reached. 

For expanded status displays only, the remainder of the display is a summary status of 
the various DI components in the DI, network solutions, and communication lines. For 
specific information about these status entries, see the other display status commands 
(DISPLAY_HARDWARE .STATUS, DISPLAY_LINE .STATUS, DISPLAY_NETWORK_ 
STATUS) described later in this chapter. 



Total Memory 
Available Memory 

Extents 
Deloadable Memory 
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DISPLAY_EGP_PEER STATUS (DISEPS) 
NETOU Command 

Purpose Displays the current status of the Exterior Gateway Protocol (EGP) peers 
and the configured parameters for a specific device interface. 

Format DISPLAY_EGP_PEER .STATUS 

DISPLAY _OPTION = keyword value 

Parameters DISPLAY JOPTION (DO) 

Displays the level of status information to be reported for one or more 
EGP peers. The following keyword values are allowed. 

Keyword Value Description 



PEERS (P) Displays a list of the defined EGP gateway 

peers and the current status of each gateway. 

REPORTED _NETS (RN) Displays a list of the local network addresses 

that are reportable to the defined peers. 

FIXED .PARAMETERS Displays the configured parameters for each of 

(FP) the defined EGP gateway peers. 

ALL (A) Displays all of the specified keyword values. 

Default is PEERS. 

Responses The following header precedes the requested peer status information (see 
example). 

EGP PEERS: 
If no EGP peers are defined, the following response replaces the display. 

No EGP peers defined for this DI. 
The following header precedes the reportable nets display (see example). 

EGP REPORTABLE NETS: 

If no reportable nets are defined, the following response replaces the 
display. 

No EGP Reportable Nets defined for this DI. 
The following header precedes the fixed parameter display (see example). 

EGP PEER'S FIXED PARAMETERS: 
If no EGP peers are defined, the following response replaces the display. 

No EGP peers are defined for this DI. 
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Examples Senc c='d1 splay _egp_peer .status do=al1' 

EGP Status 



EGP PEERS: 














Peer's IP Addr 


State 


R 


S 


T1 


T2 


M 


10.61.00.02 


UP 


20 


300 


25 


105 


P 



EGP REPORTABLE NETS: 
128.05.00.02 

EGP PEER'S FIXED PARAMETERS: 
Peer's IP Addr USE 

10.61.00.02 AUTO 

asn mhi mpi rcl hudt hact anut andt pnut pndt 
78 30 120 30 3600 120 3 1 1 

tha tpa rha rpa 
10 10 5 15 
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EGP Peer Status Display Description 

The DISPLAY_EGP_PEER_STATUS command supports display status for the 
DISPLAY_OPTION values of PEERS, REPORTED _NETS, and FIXED .PARAMETERS. 

The display option PEERS returns the following information: 

Column Contents 



Peer's IP addr 
State 



R 
S 
Tl 
T2 

M 



The network address of a directly connected gateway peer that was 
defined by a DEFINE _EGP_PEER command. 

The EGP protocol state for the PEER. The following are possible 
values: 

Value Description 



STOP The peer protocol has not been started. 

IDLE The peer has been started, but no protocol activity is in 

progress. 

AQSN The gateway periodically retransmits REQUEST 
commands to the peer to "acquire" the peer. 

DOWN The gateway has received a REQUEST or a CONFIRM 
response from the peer but the peer is still declared 
down. The gateway periodically retransmits HELLO 
commands. 

UP The protocol has declared the peer up. The gateway 

periodically retransmits HELLO and POLL commands 
and processes all commands and responses received. 

CEASE STOP_EGP_PEER command causes the gateway to 

transmit a CEASE command and go to the CEASE state. 

The receive sequence number. 

The send sequence number. 

The interval between HELLO retransmissions. 

The interval between POLL retransmissions. 

The mode in which the protocol is operating. The possible values 
are: 

Value Description 



A 
P 
? 



Active mode 

Passive mode 

Mode is unknown at this time (state is STOP, IDLE, 
AQSN, or CEASE). 
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The display option 
network. 

Value 



REPORTED _NET returns the following values for each reportable 



Meaning 



IP addr 

The display option 

Column 



The network address to be reported to all peers. 
FIXED .PARAMETER returns the following values for each peer. 
Contents 



Peer's IP addr 



Use 



asn 

mhi 
mpi 
rci 

hudt 

hact 

anut 

andt 

pnut 

pndt 



The network address of the peer configured by the DEFINE _EGP_ 
PEER command. 

The type of peer that was configured. 

Value Description 



AUTO 



MANUAL 



BACKUP 



The peer may be replaced by a BACKUP peer 
if acquisition is not possible. 

The peer may not be replaced by a BACKUP 
peer if acquisition is not possible. 

The peer may be acquired to replace an AUTO 
peer that cannot be acquired. 



Autonomous system number of the local network assigned by SRI 
International. 

Minimum hello interval in seconds. 

Minimum poll interval in seconds. 

Request/cease interval. Time in seconds between retransmission of 
request or cease commands. 

Hold up/down time-out. Time in seconds the protocol waits for a 
peer response in the UP or DOWN states. 

Hold acquisition/cease time-out. Time in seconds the protocol waits 
for a peer response in the acquisition or cease states. 

Active neighbor up threshold. The threshold used in the neighbor 
reachability algorithm for an active peer. 

Active neighbor down threshold. The threshold used in the neighbor 
reachability algorithm for an active peer. 

Passive neighbor up threshold. The threshold used in the neighbor 
reachability algorithm for a passive peer. 

Passive neighbor down threshold. The threshold used in the 
neighbor reachability algorithm for a passive peer. 
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Column Contents 



tn » Transmit hello adjust. The number added to the hello transmission 

interval in seconds. 

tpa Transmit poll adjust. The number added to the poll transmission 

interval in seconds. 

rha Receive hello adjust. The number subtracted from the minimum 

receive hello interval in seconds. 

n>a Receive poll adjust. The number subtracted from the minimum 

receive poll interval in seconds. 
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DISPLAYJESISJROUTING OPTIONS (DISERO) 
NETOU Command 

Purpose Returns the current value of OSI ES-IS routing support attributes. 

Format DISPLAY_ESIS .ROUTING OPTIONS 

DISPLAY_OPTION=list 1..7 of key 

Parameters DISPLAY jOPTION (DO) 

Specifies one or more ES-IS routing option values to be displayed. Default 
is ALL. The allowed keyword values are: 

ROUTING_FUNCTION (RF) 

ES .CONFIGURATION .TIMER (ECT) 

IS .CONFIGURATION .TIMER (ICT) 

ROUTING .CACHE .INACTIVITY.TIMER (RCIT) 

ENABLE .CHECKSUM (EC) 

CONS.ROUTING.SUPPORT (CRS) 

ENABLE .CONFIGURATION .NOTIFY (ECN) 

ALL 

Responses The following header precedes the options display (see example): 

ES-IS Routing Support options 

Examples d i sp 1 ay_esi s_rout 1 ng_opt 1 ons 

ES-IS Routing Support options 
rout ing_funct ion - COMBINED 
es_configuration_timer = 120 
1s_configurat1on_t liner - 30 
routing_cache_1nact1v1ty_t1mer * 300 
enable_checksum = FALSE 
cons_routing_suppopt - TRUE 
enab1e_configurat1on_notify = TRUE 
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DISPLAY_ESIS .ROUTING .STATUS (DISERS) 
NETOU Command 



I Purpose 



Format 



Parameters 



Displays the operating status of the ES-IS routing entity. This display 
includes key ES and IS routing data stores, including the data store for 
the list of known intermediate systems, the list of networks in the catenet, 
the cache for routing based on the NSAP address, and the list of known 
end systems. 

DISPLAY_ESIS .ROUTING _STATUS 

DISPLAY _OPTION= keyword value 

DISPLAY JOPTION (DO) 

Specifies the level of status for the general status display. The allowed 
keyword values are: 

SUMMARY (S) 
NDS (N) 
CDS (C) 
ISHDS (I) 
ESHDS (ES) 
EXPANDED (E) 

Default is SUMMARY. 

Responses The following header precedes the status display (see example): 

ES-IS Routing Status 

Within the status display, the following response appears if the given data 
store is empty: 



| Examples 



No entries present for this Data Store 

display.es is_routing_status 

ES-IS Routing Status 

Network Entity Title ' 39840F01BB7BOOOOOOOOOQ31910800Z530042000 

Data Store Entries Date/tine and reason for- last update 

90/05/29 07.02.56 Internal IS- IS change 

90/05/29 08.24.03 ISH used 0800253000C1 

90/05/28 20.09.37 ISH PDU 080025300431 

90/05/28 14.55.29 Timeout O80D25100083 

display _esis_routing_status display .optionee 

ES-IS Routing Status 

Network Entity Title = 39840F01BB7B0000000000319108002530042000 

Data Store Entries Date/tine and reason for last update 

90/05/29 07.02.56 Internal IS- IS change 

90/05/29 08.24.03 ISH used 0800253000C1 

90/05/28 20.09.37 ISH PDU 080025300431 

90/05/28 14.55.29 Timeout 080025100083 



Network 


4 


Cache 


3 


ISH 


3 


ESH 


2 



Network 


4 


Cache 


3 


ISH 


3 


ESH 


2 



ES-IS Routing Network Data Store ( NDS ) 

Network Cost 

104(16) 

1056(16) 

3191(16) 10 

3S03( 16) 3050 
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ES-IS Routing Cache Data Store < CDS ) 

NSAP Address Type 



Count 



47840202000 1000300552AB68802 ESH PDU 257 

39840F01BB7B000000000031910800253000C101 1SH used 3290 
39840F01BB7B0000000000319108002530043101 RD for IS 3290 



SNPA 

08006028421 1 
0800253006B8 
080025300431 



ES-IS Routing 1SH Data Store ( ISHDS ) 

Network Entity Title HT 

39840F018B7B000000000031910800253000C100 240 

47840202000100030004216688 1200 

39840F01BB7B00O0QO0000319108002530043100 480 



Network SNPA 

3191(16) 0800253000C1 

200(16) 080060284210 

3191(16) 080025300431 



ES-IS Routing ESH Data Store ( ESHDS ) 

NSAP Address HT 

39840FO 1 BB7B00O0000000319 1 080025 1 0007200 240 

47840202000 100Q300552AB68802 600 



Network SNPA 

3191(16) 080025100072 
200(16) 080060284211 
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DISPLAY_ESIS_ROUTING_STATUS (DISERS) 
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DISPLAY_ETHER _NET_OPTIONS (DISENO) 
NETOU Command 

Purpose Displays the configuration of an Ethernet network solution. The network is 
identified by logical name. If no name is specified, the configuration of all 
Ethernet networks defined for the system is displayed. 

Format DISPLAY JETHER _NET_OPTIONS 

NETWORK _NAME = list 1..15 of name 
DISPLAY JOPTION = list 1..10 of keyword value 

Parameters NETWORK JVAME (NN) 

Displays the logical name of an Ethernet network assigned by a DEFINE _ 
ETHER _NET command. Default displays all defined Ethernet networks. 

DISPLAY JOPTION (DO) 

Specifies one or more of the network attributes for display. The allowed 
keyword values are: 

TRUNK _NAME (TN) 
NETWORK _ID (NI) 
NETWORK _NAME (NN) 
COST (C) 

RELAY_ALLOWED (RA) 
MULTICAST_NETWORK (MN) 
ROUTING_INFO .NETWORK (RIN) 
OUTPUT_QUEUE_LIMIT (OQL) 
INCOMING _SERVICE_ACCESS (ISA) 
OUTGOING .SERVICE .ACCESS (OSA) 
ALL (A) 

Default is ALL. 

Responses The following header precedes the Ethernet network options display (see 
example). 

Ethernet Network options 

Within the options display, one of the following responses is inserted if a 
NETWORK _NAME is not defined, is not an Ethernet network, or no 
Ethernet networks are defined, respectively. 

Network <name> is not defined. 

Network <name> is not an ETHERNET network. 

No ETHERNET networks are defined for this system. 
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Examples d1splay_ether_net_opt1ons nn=ethernet_2 

Ethernet Network options 

trunk_name = $ESCI3 

network.ld * 123456(16) 

network_name = ETHERNET_2 

cost = 20 

re lay_al lowed = yes 

mult icast.net work = yes 

rout1ng_1nfo_network = yes 

output.queue.limlt - 30000 

1ncoming_servlce_access - batch_support, f1le_transfer, 

1 nt er act 1 ve , net wor k .management 
1ncoming_service_access titles = none 
outgo1ng_service_access = file_transfer, interactive 
outgo1ng_serv1ce_access titles » none 
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DISPLAYJETHER _TRUNK .OPTIONS (DISETO) 
NETOU Command 

Purpose Displays the configuration of Ethernet trunks. An Ethernet trunk is 

identified by its trunk name. If a trunk name is not entered, the 
configuration of all Ethernet trunks defined for the system is displayed. 

Format DISPLAY.ETHER .TRUNK .OPTIONS 

TRUNK JStAME = list 1..15 of name 
DISPLAY JOPTION = list of keyword value 

Parameters TRUNK JSTAME (TN) 

Specifies the logical name assigned to the trunk by a DEFINE _ 
ETHERNETJTRUNK command. Default displays all defined Ethernet 
trunks. 

DISPLAY JOPTION (DO) 

Specifies one or more of the trunk attributes for display. The allowed 
keyword values are: 

SLOT (S) 

TRUNK _NAME (TN) 
MAX_FRAME_SIZE (MFS) 
INTERFRAME .SPACING (IS) 
ALL (A) 

Responses The following header precedes the options display (see example). 

ETHERNET Trunk options 

Within the options display, the following responses are inserted if a 
trunk _name is not defined, is not an Ethernet trunk, or if no Ethernet 
trunks are defined. 

Trunk <name> is not defined. 

Trunk <name> is not an ETHERNET trunk. 

No ETHERNET trunks are defined for this system. 

Examples d1splay_ether_trunk_opttons tn=ethernet_dm02 

ETHERNET Trunk options 
slot - 4 

trunkjiame = ETHERNET_CIM02 
max_frame_slze = 1500 
1nterframe_spacing « 96 



60000414 C 



DISPLAY Commands 8-27 



DISPLAY J1IJE_1X)AD_STA.TUS (DISPLS) 

DISPLAY_FILE _LOAD .STATUS (DISFLS) 
NETOU Command 

Purpose Displays the files that have been loaded into DI memory by the LOAD_ 
PILE command. The DISFLS command has no parameters. 

The file load status display is described following the command examples. 
Format DISPLAY JFILE .LOAD .STATUS 

Parameters None. 

Responses The following header precedes the file load status display (see example), 
display _file _load _status 
If no files are loaded, you receive the following response. 
No files are currently DI memory-resident. 
Examples d 1 sd 1 ay_f i 1 e_ 1 oad_st at us 

File * LVLTUP 

type - USER.PROCEDURE size = 900 bytes, file opens = 
loaded from : CYBER 180 SN312 , M0DEL19 08/11/88 02:15:32 

File = IPGTUP 

type = USER.PROCEDURE size = 1210 bytes, file opens = 2 

loaded from : CYBER 180 SN312 , MODEL19 08/11/88 11:15:31 

There are 2110 bytes in 10 buffers 1n the 2 files displayed. 

File Load Status Display Description 

The file load status display information includes the following information about each 
file currently resident in DI memory. 

File The name of the file currently in DI memory. 

type The type of file currently in DI memory. 

size The size of the file currently in DI memory. 

file The count of the accesses to this file, 

opens 

loaded from The name, serial number and system model of the system from which 

the file was loaded. This information displays only if the file was 
loaded from a NOS/VE system. 
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DISPLAY_FILE ^SUPPORT (DISFS) (NOS MDI Only) 
NETOU Command 

Purpose Displays file types supported by an Independent File Access ME residing 
on a NOS MDI or MTI. The display also indicates the status of the 
Independent File Access ME connection to the host through the trunk. If 
the status is DOWN, the connection is down. If the status is ACTIVE, the 
connection is up and in use. 

Format DISPLAY.FILE .SUPPORT 

TRUNK JfAME = name 

Parameters TRUNK _J!AME (TN) 

Displays the trunk name of the logical link which is used to support the 
file access connection. If this parameter is not specified, the default trunk 
is used. Default is specified by a DEFINE _SYSTEM command. 

Responses The following header precedes the DISFS display (see example). 

File Types supported for trunk <name>. Connection is < state >. 

Within the status display, the following responses replace the display 
response if file support is not defined for a specified trunk or if no file 
support is defined for the system. 

File Support is not defined for trunk <name>. 

File Support is not defined for the system. 

Remarks For more information on File Access Management Entity, see the Systems 
Programmer's Reference manual, Volume 2, Network Management Entities 
and Layer Interfaces. 

Examples display_f 1 le„support 

File Types supported for trunk 03. Connection 1s active. 

USER_PROCEDURE 

TERMINAL.PROCEDURE 

LOAD_PROCEDURE 

LIBRARY 

EXCEPTION 

DUMP 

CONFIGURATION 

BOOT 
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DISPLAY_HARDWARE STATUS (DISHS) 
NETOU Command 

Purpose Displays status of the logic boards in a DI or the status of an ICA-II in a 
CDCNET host. If you issue the command, with no parameters, to a DI, you 
receive the status of all boards. If you issue the command, with 
parameters, to a DI, you receive the status of the specified devices. If you 
issue the command, with no parameters, to a CDCNET host, you receive 
the status of the ICA and all the associated interfaces. If you issue the 
command, with parameters, to a CDCNET host, you receive the status of 
the specified ICA-II interface. 

This command supports two levels of display: summary and expanded. A 
summary display includes the status of large boards, LIMs and URIs (if no 
device names are entered for a DI), or the status of boards specified by 
device name with the command. If no device name is entered for an 
ICA-II, the status of the ICA-II board and the ICI/IEI interfaces are 
displayed. An expanded display includes the summary display information 
plus the status of all subassemblies to a board, for example, LIM or URI 
boards controlled by a named CIM board. Hardware status displays are 
described following the command examples. 

Format DISPLAY_HARDWARE _STATUS 

DEVICE _FAME = Itet 1..30 of name or ALT. 
DISPLAY _OPTION = keyword value 

Parameters DEVICE J* AME (DN) 

The physical name of the device for which status is to be returned. This 
parameter is optional and has no default value. 

DISPLAY JOPTION (DO) 

Displays level of status display. There are two possible values for this 
parameter. 



Keyword Value 



Description 



SUMMARY (S) 



EXPANDED (E) 



Provides status of large boards, LIMs, and URIs 
(if no device names are entered), or status of 
boards you specifically select using the 
DEVICE _NAME parameter. 

Includes the summary display information plus 
the status of all subassemblies to a board (such 
as LIM ports), or boards controlled by a card 
specified by the DEVICE _NAME parameter 
(such as LIM or URI boards controlled by a 
CIM board). 



Default is SUMMARY. 
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Responses The following header precedes the hardware status display (see example). 

Hardware Status 

Within the status display, the following response are inserted if a device 
name is unknown or if the device is not installed. 

Device name <name> unknown or not installed. 

Examples This example shows summary status for all boards in a TDI. 



d i sp 1 ay_hardware.status 












Hardware 


t Status 




























boot ROM 


device name 


state 


status 


version 


1 im/bank/port 


type enab 


level 


JMPBO 




on 


active 


0000(16) 






n/a 


160A 


$PMM1 




on 


active 


0008(16) 






n/a 


160A 


SSMM2 




on 


active 


0001(16) 


2 




n/a 


0000 


SMC 1 3 




on 


protocol misiii. 


0000(16) 






yes 


050C 


SCIM4 




on 


configured 


0001(16) 


0,1 


.2.3 


no 


2702 


SC1M5 




down 


not config. 


0000(16) 






yes 


2702 


SESCI6 




on 


active 


0000(16) 






no 


0806 


SMCI7 




on 


active 


0000(16) 






yes 


050C 


SLIMO 




on 


configured 


0008(16) 


4 




RS232 




$LIM1 




down 


configured 


0009(16) 


4 




RS232 




$L1M2 




on 


not config. 


0000(16) 


2 




RS449 




SLIM3 




on 


not config. 


0000(16) 


2 




RS449 




SUR14 




on 


configured 













This example shows the summary status display for a LIM. 



display.hardware.status dn«$l 1m4_port0 

Hardware Status 

device name state status version 1 im/bank/port 
$LIM4_PORT0 down configured 



type 
ASYNC 



boot ROM 
enab level 



This example shows the summary status display for a MPB. 

dishs dn=Smpb0 



Hardware Status 

boot ROM 
device name state status version 1 im/bank/port type enab level 
SMPB0 on configured 0000(16) n/a 100A 



finnnmiA c. 
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This example shows the expanded status display for all LIMs. 
chshs do=expanded 



Hardware Stat 


US 








device name 


state 


status version 


1 Im/bank/port 


type 


$LIM0 


on 


configured 


4 


RS232 


$LIM1 


on 


configured 


4 


RS232 


$LIM2 


on 


configured 


4 


RS232 


$LIM3 


on 


configured 


4 


RS232 


$LIM4 


on 


configured 


4 


RS232 


$LIM5 


on 


configured 


4 


RS232 


$LIM6 


on 


configured 


4 


RS232 


$LIM7 


on 


configured 


4 


RS232 


$LIM0_PORT0 


on 


configured 




ASYNC 


$LIM0_PORT1 


on 


configured 




ASYNC 


$LIM0_PORT2 


on 


configured 




ASYNC 


$LIM0_PORT3 


on 


configured 




ASYNC 


$LIM1_PORT0 


on 


configured 




ASYNC 


SLIM 1 .PORT 1 


on 


configured 




ASYNC 


$LIM1_P0RT2 


on 


configured 




ASYNC 


$LIM1_P0RT3 


on 


configured 




ASYNC 


$LIM2_PORT0 


on 


configured 




ASYNC 


$LIM2_P0RT1 


on 


configured 




ASYNC 


$LIM2_P0RT2 


on 


configured 




ASYNC 


$LIM2_PORT3 


on 


configured 




ASYNC 


$SMM2_BANK0 


on 


configured 


2 




$SMM2_BANK1 


on 


configured 


2 





This example shows the summary status display for an ICA-II system. 

d 1 sp lay_hardware_status 
Hardware Status 













boot ROM 


device name 


state 


status version 


1 im/bank/port 


type 


enab level 


$ICA 


on 


active 1300(16) 






n/a 5204 


SICA.IC1 


on 


conf igured 




ICI 




SICA.1E! 


down 


conf igured 




IEI 





This example show the summary status display for a specific ICA-II svstem 
(DEVICE _NAME=$ICA) 



display _hardware_status dn«$ica 
Hardware Status 













boot 


ROM 


device name 


state 


status 


version 


1 im/bank/port 


type enab 


level 


S1CA 


on 


active 


1300(16) 




n/a 


5204 



This example shows the summary status display for a specific ICA-II 
interface (DEVICE _NAME=$ICA__ICI). 

display.hardware.status dn*$lca_lci 

Hardware Status 

boot ROM 
device name state status version 1 im/bank/port type enab level 
$1CA_ICI on configured ici 
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Hardware Status Display Description 

The hardware status display describes each board as follows. 

device name The physical name of the board or LIM port, specified as $board 

type_slot number, as in $MPB0, $PMM1, $CIM4 or $ICA. An empty 
board slot for a major board is assigned the slot number. 

state Operational state of the board, which may be: 

on Operational; available for use by the 

communications system. 

down Not operational; available for diagnostic tests 

only. 

off Not operational or not installed; not available 

for use without intervention, such as installing 
boards and changing the board's operational 
state by the CHANGE _ELEMENT_STATE 
command. 

status Indicates how the board is being used by the DI's communications 

system. A board may have one of the following status conditions. 

not avai l . The port exceeds the 48-port limit for LIM 

ports connected to one CIM board and is 
unavailable for use. 

configured Board has been configured (prepared) for use by 

the communications system. 

not config. Board is not configured for use by the 

communications system. 

enabled Board is configured, and is in use by the 

communications system. 

active Active communications are being carried over 

the device. Appropriate communications 
protocols are being exchanged. 

protocol mismatch MCI cannot support protocol version requested 

by peripheral processor. Reflects status of MCI 
board. 

version The current hardware version of the board (not applicable to ports). 
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llm/bank/port This section gives information about the different types of boards and 
any subordinate DI hardware that a board controls. This status 
information is provided under the following headers. 

1 1m The LIM and URI boards a CIM board controls. 

bank The number of memory banks on a SMM board. 

port The number of ports defined for a LIM board. 

type For LIMs, this field describes the physical connection type 

on LIM board, such as RS-232 and RS-449. For ports, this 
field describes the terminal interface program (TIP) 
controlling the port, such as the asynchronous TIP. Compare 
the information under the Type column in the first and 
second examples to see how information in the Type column 
differs between LIMs and ports. 

boot Specifies whether boot is allowed over this device, 

enabled (Applicable to only ESCI, CIM, and MCI boards.) 



ROM Specifies the level of the major boards. 

leva] 



level 
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DISPLAY JHDLC_NET_OPTIONS (DISHNO) 
NETOU Command 

Purpose Displays the configuration of an HDLC network. You can display the 

configuration of a single HDLC network or all HDLC networks defined for 
the specified system. Address the network by its logical name. 

HDLC network option displays are described following the command 
examples. 

Format DISPLAY.HDLC _NET_OPTIONS 

NETWORK JXAME = list 1..15 of name 
DISPLAY _OPTION = list 1..9 of keyword value 

Parameters NETWORK _NAME (NN) 

Logical name of an HDLC network assigned by a DEFINE _HDLC_NET 
command as described in this manual. 

DISPLAY JOPTION (DO) 

Selects one or more network attributes for display. The following display 
options, described in the DEFINE _HDLC _NET command, are allowed. 

TRUNK _NAME (TN) 
NETWORK _ID (NI) 
NETWORK _NAME (NN) 
COST (C) • 
RELAY_ALLOWED (RA) 
ROUTING_INFO .NETWORK (RIN) 
OUTPUT_QUEUE .LIMIT (OQL) 
OUTGOING .SERVICE .ACCESS (OSA) 
INCOMING.SERVICE .ACCESS (ISA) 
ALL (A) 

Default is ALL. 

Responses The following header precedes the HDLC network options (see example). 

HDLC Network options 

Within the options display, one of the following responses is inserted if 
NETWORK .NAME is not defined, is not an HDLC network, or no HDLC 
networks are defined, respectively. 

Network <name> is not defined. 

Network <name> is not an HDLC network. 

No HDLC networks are defined for this system. 
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Examples This command returns a list of the options selected for the specified HDLC 
network. 

d1splay_hd1c_net_opt1ons nn=hdlc_network_2 

HDLC Network options 

trunk_name = HDLC_TRUNK_LINE_1 

network. id = 123456(16) 

network_name = HDLC_NETW0RK_2 

cost = 2000 

re lay.at lowed ■ yes 

rout1ng_lnfo_network ■ yes 

output_queue_Um1t ■ 30000 

1ncoming_serv1ce_access » f 11e_transfer 

incoming_serv1ce_access titles = ARH907 

outgo1ng_servlce_access - file.transfer, Interactive 

outgo1ng_service_access titles ■ none 
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DISPLAY_HDLC _TRUNK .OPTIONS (DISHTO) 
NETOU Command 

Purpose Displays the configuration of HDLC trunks. You address an HDLC trunk 
by its trunk name. If you enter no trunk name, the display presents the 
configuration of all HDLC trunks defined for the system. 

Format DISPLAY.HDLC .TRUNK .OPTIONS 

TRUNK _NAME = list 1. .15 of name 
DISPLAYJOPTION = list of keyword 

Parameters TRUNK JJAME (TN) 

Logical name of an HDLC trunk. Name assigned by a DEFINE .HDLC. 
TRUNK command as described in this manual. 

DISPLAYJOPTION (DO) 

Selects one or more trunk attributes for display. The following keywords, 

described in the DEFINE. 

allowed. 



.HDLC_TRUNK command in this manual, are 



LIM (L) 
PORT (P) 

LOCAL .ADDRESS (LA) 
REMOTE .ADDRESS (RA) 
. TRUNK _NAME (TN) 
OPTIONS (O) 

MAX.UNACK.FRAMES (MUF) 
SREJ .QUEUE .SIZE (SQS) 
MAX .FRAME .SIZE (MFS) 
PF.RECOVERY.TIMER (PRT) 
ERROR.RECOVERY.TIMER (ERT) 
RETRANSMISSION.LIMIT (RL) 
TRUNK .SPEED (TS) 
CLOCKING (C) 

INTERACTIVE .BANDWIDTH (IB) 
DRIVER (D) 
TRAFFIC .TYPE (TT) 

UNSTABLE .TRUNK .DISCONNECT.TIMER (UTDT) 
ALL (A) 

Default is ALL. 

Responses The following header precedes the HDLC trunk option display (see 
example). 

HDLC Trunk options 

Within the options display, one of the following responses is inserted if a 
TRUNK .NAME is not defined, is not an HDLC trunk, or no HDLC 
trunks are defined, respectively. 

Trunk <name> is not defined. 

Trunk <name> is not an HDLC trunk. 

No HDLC trunks are defined for this system. 



60000414 C 



DISPLAY Commands 8-37 



DISPLAY_HDLC_TRUNK_0PTIONS (DISHTO) 



Examples d1splay_hdlC_trunk_opt1ons tn*HDLC_TRUNK_1 

HDLC Trunk options 

11m » 3 

port - 1 

local .address - 123 

remote.address = 85 

trunk_name = HDLC.TRUNK.1 

options ■ (SIM_ON,RESET_ON,IFRAME_ON) 

max_unack.fr ames - 7 

srej.queue.slze ■ 4 

max_frame_s1ze - 1500 

pf .recover y_t Imer * 500 

error.recovery.tlmer » 2000 

retransm1ss1on_l1mlt = 20 

trunk.speed = 19200 

clocking * transmit 

interact lve_bandw1dth - 7 

driver = hdlc.normal 

trafflc.type - CDCNET 

unstab1e_trunk_d1sconnect_t1mer = 
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DISPLAY_ICA .SYSTEM _STATUS (DISISS) 
NETOU Command 

Purpose Returns general information about the operation of an ICA-II and resource 

usage in the ICA. The DISISS command is an alias of the DISPLAY_DI_ 
SYSTEM _STATUS command. See the DISDSS command description, earlier 
in this chapter, for more information. 
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DISPLAY_IP__FILTER (DISIF) 
NETOU Command 

Purpose Displays previously configured IP filter entries for a specified IP network 
or all IP networks. 

Pormat DISPLAY_IP_FILTER 

IPJVETWORK = list 1..4 of 0..255 or ALL 

Parameters IP_NETWORK (IN) 

Specifies a particular IP network or all IP networks currently defined 
within this system. The IP filter entries from this IP network are 
displayed. If you specify ALL, the IP filter entries from all IP networks 
are displayed. The default is ALL. 

Responses All IP filter entries for the specified IP network or all IP networks are 
displayed. The IP addresses, IP masks, port numbers, and access allowed 
values are shown for each entry. The display is ordered the same as for IP 
filter processing (first in first out). 

The following response is generated if no IP filter is defined, regardless of 
input errors: 

No IP filter entries are defined on IP network <ip_network>. 

-ERROR- IP network <ip_network> is not defined. 

Examples display.lp.f liter ip_network=(129, 179,52) 

IP Filter Entries for IP network 129.179.52: 



Source 
Allowed Protocol IP Address 
Mask 



Destination 
Port ranges IP Address 
Mask 



Port ranges 



TRUE 



any 



129.179.000.000 1..126 
255.255.000.000 



FALSE 23. . 25 any 



129,179.63.000 126.. 255 
255.255.255.000 

129.179.64.11 1.. 65535 
255.255.255.255 



display.lp.f liter ip_network=( 129, 179,52) 

No IP filter entries are defined on IP network 129.179.52. 



display.lp.f liter 1n=( 129, 179,54) 
—ERROR— IP network 129.179.54 is not defined. 
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DISPLAY__IP_STATUS (DISIS) 
NETOU Command 



Purpose 



Format 



Parameters 



Responses 



Displays the current status of the IP routing tables for a DI. The display 
includes the values configured from the DEFINE _IP_NET and DEFINE. 
IP_HOST commands. The display includes the routing information from 
ARP, EGP, and RIP for directly and indirectly connected networks, 
respectively. The display also indicates if IP Broadcast is enabled for each 
of the directly connected networks. 

IP status displays are described following the command examples. 

DISPLAY_IP_STATUS 

DISPLAY _OPTION= list of keyword values 

DISPLAY JOPTION (DO) 

Displays the level of detail the response contains. The parameter allows 
the following keyword values. 



Keyword Value 



Description 



SUMMARY (S) 



HOSTS (H) 



NETWORKS (N) 



REMOTE (R) 



EXPANDED (E) 



Displays the number of networks, hosts, and 
gateways that are currently in the IP routing tables. 

Displays all directly connected host IP addresses and 
respective hardware addresses (Ethernet or DTE). 

Displays the status of all directly connected IP 
networks/subnets. 

Displays all remote networks/subnets and the 
associated gateway used to reach it. 

Displays all the information available with the other 
keywords. 



Default is SUMMARY. 

The following header precedes the status display (see example). 

IP Routing Table Status 

If no Routing table is defined (for example, if no locally attached IP 
networks or hosts are defined), the following response replaces the status 
display. 

No IP Routing table entries are defined for this system. 
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Examples 



disp1ayjp_status display .opt ton - expanded 
IP Routing Table Status 



IP IP Local 
Hosts Gateways 
5 1 4 

Directly Connected Hosts 



CDC Remote Connected 
Hosts Networks Networks 
1 6 4 



Type 


IP Address 


Ethernet/DTE 
Address 


Owner 






IP HOSt 


129.179.1.1 


0800253003aa 


ARP 






IP Host Agent 


129.179.1.2 


080025300b33 


IPSR 






CDC Host 


129.179.1.51 


080025100077 


IPSR 






Local 


129.179.1.50 


080025100077 


IPSR 






Local 


129.179.2.50 


080025100077 


IPSR 






IP Host 


129.179.2.1 


080025100079 


ARP 






IP Gateway 


10.63.0.124 


000001246300 


IP 






Local 


10.63.0.1 


000001256300 


IPSR 






IP Host 


129.180.0.2 


10297021 


IPSR 






IP Host 


129.180.0.3 


10297342 


IPSR 






Directly Connected Networks/Subnets 








Network 


Type Status Subnet 


RARP 


IP 


Trunk 






Mask 


Status 


Brdcst 


Name 


129.179.1.0 


Ethernet UP 


24 


ON 


ON 


SESCI6 


10.O.0.0 


X.25 CONGESTED 


OFF 


OFF 


DDN.TRUNK 


129.179.2.0 


HDLC DOWN 


! 24 


ON 


OFF 


$L1M4_PORTO 


129.180.0.0 


X.25 UP 





OFF 


OFF 


PDN.TRUNK 


Remote Networks/Subnets 










Network 


Gateway Address 


Hops Owner 








128.3.0.0 


129.179.1.52 


1 RIP 








26.0.0.0 


10.63.0.124 


1 EGP 








129.179.3.0 


129.179.1.52 


1 RIP 








129.179.4.0 


129.179.2.3 


3 IPSR 








129.181.0.0 


129.180.0.2 


1 IPSR 








129.182.0.0 


129.180.0.2 


2 IPSR 
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IP Status Display Description 

The summary line status display information includes: 

IP "osts The number of IP hosts currently in the IP Routing tables. 

IP Gateways 



Local 



CDC Hosts 



Remote Networks 



Connected Networks 



The number of gateways currently in the IP Routing tables for 
the DI. 

The number of IP addresses configured for the local DI 
supported by the specified DI. 

The number of IP addresses configured for the Control Data 
hosts supported by the specified DI. 

The number of remote (indirectly connected) networks currently 
in the IP Routing tables. 

The number of directly connected networks currently in the IP 
Routing tables. 



The expanded status displays routing information for directly connected IP networks, 
the remote networks, and associated gateways used to reach each IP network. The 
directly connected host information includes the following: 



Type 



IP Address 



Ethernet/DTE 
Address 



Owner 



Identifies the type of host to which the address refers. The host 
may be a foreign host (IP Host), the local DI (Local), a Control 
Data Host supported by this DI (Control Data Host), or the host 
for which the DI is the ARP agent (IP Host Agent). 

Identifies the IP address of all hosts on the directly connected 
IP networks. Only IP gateway addresses with a zero third byte 
are displayed. LAN extension IP host addresses are not 
displayed on X.25 IP networks with a transparent gateway. 

Identifies the Ethernet or X.25 DTE address corresponding to 
the IP address. Ethernet addresses are configured or learned by 
ARP. IP converts the DTE addresses from the IP address. 

Identifies the software component that created the IP routing 
table entry. If IPSR is the owner, a configuration command 
created the entry. 
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The directly connected networks/subnets information includes the following: 
Network 



Type 

Status 
RARP Status 
IP Brdcst 
Subnet Mask Size 
Trunk Name 



Identifies the IP network number currently in the IP routing 

tables. 

Identifies the type of network; for example, Ethernet, X.25, or 
HDLC. 

Reports the status of the network. 

Reports the status of the RARP for the network. 

Reports the status of the IP Broadcast for the network. 

Reports the number of bits in the subnet mask. 

Reports the name of the CDCNET trunk of the directly 
connected network/subnet. 



The remote network displays the following information about remote networks and 
subnetworks: 



Network 



Gateway Address 



Hops 



Owner 



Identifies the IP network number currently in the IP Routing 
tables. 

Identifies the IP address of a gateway (on a directly connected 
network) through which the remote network can be accessed 
from this DI. Also identifies the Ethernet address for an ARP 
learned gateway. 

Reports the number of hops required to reach the remote 
network from this DI. 

Identifies the software component that created the IP Routing 
table entry. If IPSR is the owner, a configuration command 
created the entry. 
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DISPLAYJSIS .ROUTING .STATUS (DISIRS) 
NETOU Command 



Purpose 



Format 



Parameters 



Displays the operating status of the IS-IS Routing Entity (the CDCNET 
version of IS-IS, not the OSI version of IS-IS). This display includes key 
routing data stores, including the data store for routing both CLNS and 
CONS PDUs as well as the data store for received IS-IS PDUs. 

DISPLAY_ISIS ..ROUTING STATUS 
DISPLAY _OPTION= keyword value 

DISPLAY JOPTION (DO) 

Specifies the level of status for the general status display. The allowed 
keyword values are: 

SUMMARY (S) 
LORDS (L) 
RDCNDS (R) 
ALIAS (A) 
NAPDS (N) 
EXPANDED (E) 

Default is SUMMARY. 

Responses The following header precedes the status display (see example): 

IS-IS Routing Status 

Within the status display, the following response appears if IS-IS is 
configured but the given data store is empty: 

No entries present for this Data Store 

Examples d 1 sp 1 ay_ i s 1 s_rout 1 ng_st at us 

IS-IS Routing Status 

number of LCRDS entries =4 

number of RDCNDS entries = 2 

number of Inactive networks = 1 

number of congested networks = 1 

number of ALIAS entries = l 

number of NAPDS prefixes = 3 
maximum hop count to any system = 2 

last LCRDS update occurred at 90/05/29 07.02.56 due to a change in 
system 0800253000C1 because of a congested network 
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d1sp1ay_1s1s_rout1ng_ status d1splay_opt1on=e 

IS-IS Routing Status 

number of LCRDS entries = 4 

number of RDCNDS entries = 2 

number of Inactive networks - 1 

number of congested networks = 1 

number of ALIAS entries = 1 

number of NAPDS prefixes = 3 
maximum hop count to any system = 2 

last LCRDS update occurred at 90/05/29 07.02.56 due to a change in 
system 0800253000C1 because of a congested network 

IS-IS Routing Least Cost Routing Data Store ( LCRDS ) 

Destination network 104(16) , number of active paths = 1 
Next hop network/system PDU count Hops Total cost 
104(16)/080025300420 1 

Destination network 1056(16) , number of active paths = 1 
Next hop network/ system PDU count Hops Total cost 
1056(16)/080025300420 1 

Destination network 3191(16) , number of active paths = 1 
Next hop network/system PDU count Hops Total cost 
3191(16)/080025300420 6821 1 10 

Destination network 3603(16) , number of active paths = 1 
Next hop network/system PDU count Hops Total cost 
3191(16)/0800253000C1 1473 2 3060 CONGESTED 

IS-IS Routing Received Directly Connected Network Data Store (RDCNDS) 

System 0800253O0OC1 , Last Received RIDU Sequence Number 5988 

Network Cost Status 

3191(16) 10 ACTIVE 

3603(16) 3050 CONGESTED 

System 080025300431 , Last Received RIDU Sequence Number 656117 

Network Cost Status 
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3191(16) 10 INACTIVE 

3603(16) 3050 CONGESTED 



IS-IS Routing ALIAS Data Store ( ALIAS ) 

System Inactive Network Alias Network 

080025300431 3191(16) 3603(16) 

IS-IS Routing NSAP Address Prefix Data Store ( NAPDS ) 

System 0800253000C1 , Next hop network/system 3191(16)/0800253000C1 

NSAP Address Prefixes 

470004FF1125260800EE65432101 
470004FF 1 1 25260800EE 1 234560 1 
470003CC 



IS-IS Routing Status Display Description 

The SUMMARY display includes the following operating IS-IS status information: 

• Number of Least Cost Routing Data Store (LCRDS) entries 

• Number of Received Directly Connected Network Data Store (RDCNDS) entries 

• Number of inactive networks in the catenet 

• Number of congested networks in the catenet 

• Number of ALIAS entries 

• Number of NSAP Address Prefix Data Store (NAPDS) prefixes 

• Maximum hop count to get to any system in the catenet from this system 

• When the last LCRDS update took place (YY/MM/DD HH.MM.SS) and the reason 
for the update 

The Least Cost Routing Data Store (LCRDS) display shows the following for each 
active network in the catenet: 

• Destination network ID 

• Number of active paths to the given network 
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• The following routing information for the given network: 

- Next hop network and system to reach the given network 

- Number of PDUs routed to the given network 

- Number of hops to get to the given network 

- Whether any links are congested in the path between this system and the given 
network 

The Received Directly Connected Network Data Store (RDCNDS) display shows the 
following for each multi-homed system (other than this one) in the catenet: 

• System ID of the system 

• Sequence number of the last RIDU received from the system 

• The following Directly Connected Network information for the system: 

- Network identifier 

- Network cost 

- Status of the network (INACTIVE, ACTIVE, CONGESTED) 

- If appropriate, an additional attribute (Pseudo Net, Relay Restricted) 

The ALIAS display shows the following for each inactive network in the catenet that 
can be reached by another network: 

• System associated with the inactive and alias networks 

• Network identifier of the inactive network 

• Network identifier of the alias network (the network used for routing PDUs that 
are destined for the inactive network) 

The NSAP Address Prefix Data Store (NAPDS) display shows the following for each 
known boundary system with NSAP address prefixes in the catenet: 

• The boundary system where the given NSAP address prefixes were statically 
configured 

• Next hop network and system to reach the given boundary system 

• The list of NSAP address prefixes for the given boundary system (configured by 
ADD_NON_CDC .ROUTING _ENTRY in that system with DISTRIBUTE = TRUE) 

The expanded display is a concatenation of the SUMMARY, LCRDS, RDCNDS, ALIAS, 
and NAPDS displays. 
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DISPLAY_LINE_OPTIONS (DISLO) 
NETOU Command 

Purpose Displays the configuration of communications line(s) and unit record 
interface line(s) supported by the terminal interface programs (TIPs). 

Format DISPLAY_LINE .OPTIONS 

LINEJSTAME = list 1..15 of names 
DISPLAY JOPTION = list of keyword value 

Parameters LINE _NAME (LN) 

Displays the logical name of one or more lines. The line(s) were previously 
defined by the DEFINE _LINE commands. If you do not specify a LINE_ 
NAME the display includes all lines defined for the system. 

DISPLAY JOPTION (DO) 

Displays one or more of the line attributes. These attributes are defined by 
parameters on the DEFINE _LINE command that configured the line. For 
more information on these parameters, see the DEFINE JUNE command 
description in this manual. Allowed keyword values include the following. 

LIM (L) 

PORT (P) 

TIP_NAME (TN) 

LINE_NAME (LN) 

LINE .TYPE (LT) 

LINE_SUB_TYPE (LST) 

CARRIER _TYPE (CT) 

LINE .SPEED (LS) 

AUTO_RECOGNITION (AR) 

TRANSMISSION _BLOCK .SIZE (TBS) 

CONNECTION _CONNECT_TIMEOUT (CCT) 

CONNECTION _DISCONNECT_TIMEOUT (CDT) 

TERMINAL .DEFINITION .PROCEDURE (TDP) 

TERMINAL .USER .PROCEDURE (TUP) 

USER .CONNECTION .LIMIT (UCL) 

EIA_FLOW_CONTROL (EFC) 

CLOCKING (C) 

DATA.PARITY (DP) 

VALIDATE .USERS (VU) 

ALL (A) 

Default is ALL. 

Responses The following header precedes the options display (see example). 

Line options 

Within the options display, one of the appropriate following responses 
appears if the LINE .NAME is not defined or if no lines are defined for 
the system, respectively. 

Line .name <name> is not defined. 

No lines are defined for this system. 
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Examples d1splay_Hne_opt1ons Une.name = engin_term1nal_31 

Line options 

11m = 1 

port ■ 2 

tlp.name * ASYNCTIP 

Une.name = ENGIN_TERMINAL_31 

line.type = dedicated 

11ne_sub_type ■» LOCAL 

carr1er_type ■ constant 

11ne_speed = 9600 

auto.recognlton = none 

transm1ssion_block_s1ze = 4095 

connect 1on_connect_t1meout - 100 

connect 1on_d1sconnect .timeout = 50 

termina1_def1n1t1on_procedure = TDF_ENGIN 

term1na1_user_procedure = TDU_ENGIN_31 

user_connection_Hm1t = 4 

e1a_f 1ow_control = off 

clocking = Internal 

data_par1ty = even 

valldate.users = yes 
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DISPLAY_LINE _STATUS (DISLS) 
NETOU Command 

Purpose Displays operational status of communication lines and URI lines connected 
to a DI. You may choose status of all lines (by specifying no parameters), 
lines controlled by specific terminal interface programs (TIPs) (by 
specifying the TIP's name), or individual lines (by specifying the names of 
the lines). This command also returns the status of the terminal/batch 
devices attached to the lines and the status of the connections for the 
devices in expanded or detailed displays. 

If multiple parameters are specified, status is displayed for lines matching 
the combination of parameter values specified. For example, if you request 
status by both TIP name and line name, then the status for all enabled 
lines controlled by the TIP and status for all the lines of the names you 
specify is displayed. A named line that is also controlled by a named TIP 
appears twice in the status display. 

NOTE 



For the X.25 TIP, use DISPLAY.X25 .INTERFACE .STATUS to obtain the 
correct line status. 



Line status displays are described following the command examples. 

Format DISPLAY_LINE .STATUS 

LINE_NAME = list 1..32 of name 
TIP_NAME = list 1..7 of name 
LINEJ3TATE = list 1..5 of keyword value 
DISPLAY JOPTION = list 1..3 of keyword value 



Parameters LINE _NAME (LN) 



Logical name of one or more communication lines for which you are 
requesting status. 

TIP_J!AME (TN) 

Logical name of the TIP controlling the lines for which you are requesting 
status. 

LINE_STATE (LS) 

Selects the lines to display by line state or line states if neither the TIP_ 
NAME nor LINE_NAME parameter is specified, or if only TIP_NAME is 
specified. The following values are allowed for the LINE_STATE 
parameter. 



Keyword Value 



Description 



ACTIVE (A) 



Selects display of active lines only. 



AUTOREC .ACTIVE (AA) Selects display of lines for which auto 

recognition of line speed, parity, and/or 
character set is taking place. 



DISABLED (D) 



Selects display of disabled lines. 
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Keyword Value Description 



ENABLED (E) Selects display of active and enabled lines. 

LOADING _TIP (LT) Selects display of lines for which the 

controlling TIP is being loaded. 

ALL (A) Selects display of all lines in all line states. 

Default is ALL. 

If you do not specify TIP_NAME or LINE_NAME, all lines that are in 
the specified line state are displayed. If you specify TIP_NAME, all lines 
supported by the specified TIP that are in the selected line state are 
displayed. Selecting display by the LINE_NAME parameter overrides 
selecting display by LINE_STATE. The status of a specific line name is 
given regardless of the line state specified. 

DISPLAY JOPTION (DO) 

Selects a level of status response. The following display options are 
allowed. 

Keyword Value Description 

SUMMARY (S) Selects general line status. 

EXPANDED (E) Selects status of terminal devices connected by 

the lines. 

DETAIL (D) Selects status of the active connections for the 

terminal devices connected by the lines. 

Default is SUMMARY. 

Responses The following header precedes the line status display (see examples). 

Line Status 

Within the status display, one of the following responses is inserted if a 
line name or TIP name is not defined in the DFs logical configuration, or 
if no lines match the requested line state. 

Line_name <name> not defined. 

No <line_state> lines found for the <tip_name> tip. 

No <line_state> lines found. 

No lines defined for the <tip_name> TIP. 

No lines defined. No line status to report. 

No devices defined. 

No connections active. 
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Examples This command returns the status of all communication lines connected to a 
DI named North _TDI_2. The display option is SUMMARY. 

dlsplay_11ne_status 



Line Status 












line name 


line 


line 


tip 


line 


physical 




state 


type 


name 


speed 


device name 


ENGIN_BLD_1 


disabled 


swt. 


async 


1200 


$LIM0_PORT0 


COMPSCI_02 


active 


ded. 


async 


9600 


$LIM1_PORT0 


COMPSCI.03 


enabled 


ded. 


async 


9600 


$LIM1_PORT1 


COMPSCI.04 


act 1 ve 


ded. 


async 


9600 


$LIM1_PORT2 


COMPSCI_05 


load1ng_t1p 


ded. 


async 


9600 


$LIM1_P0RT3 


COMPSCI_06 


autorec_act 


ded. 


async 


AUTO 


$LIM2_P0RT3 



This command returns the status of a specific line, using the LINE_NAME 
(LN) parameter. 

d1splay_line_status ln=compsci_02 



Line Status 












line name 


line 


line 


tip 


line 


physical 




state 


type 


name 


speed 


device name 


COMPSCI.02 


enabled 


ded. 


async 


9600 


$LIM1_P0RT0 



This example requests an expanded status display for two lines, 
d1splay_line_status ln=(line01, line10),do=e 
Line Status 

LINE01 tip name: ASYNC 

device name: $CONSOLE_100081_00010001 address: 00/01 state: active 

LINE 10 tip name: ASYNC 

device name: $CONSOLE_ 1 0008 1_000 10000 address: 00/00 state: active 

This example requests a detail status display for one line. 

d1splay_line_status ln=line01,do=d 

Line Status 

$CONSOLE_100081_00010001 Hne name: I1ne01 
service name: ARH907 INTERACTIVE 

Input state: off output state: hold output queued: 4/2875 

> service name: ARH817 INTERACTIVE 

Input state: send output state: send output queued: 1/572 

$CONSOLE_ 100081 .00010002 line name: Hne01 

> service name: $CDCNET_COMMAND INTERACTIVE 
Input state: send output state: send output queued: 0/0 
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line Status Display Description 

The summary line status display information includes: 



line name 
line state 



line type 

tip name 

line speed 

physical device 
name 



The logical name of the communication line. 
Operational state of the line, which may be: 
act 1 ve 



deleting 
enabled 

disabling 
disabled 



switching 
downing 



reenabling 



autorec_act i ve 



1oading_t1p 



Communications are being carried over the 
line; appropriate communications protocols are 
being exchanged. 

The line is in the process of being logically 
deleted. 

The line is configured for use by the 
DEFINE _LINE command, but the line may 
not be active. 

The line is in the process of being disabled. 

The line is configured but not enabled for 
communications by the TIP controlling the 
line. The line is not started or communications 
have failed on the line. 

The line is in the process of being switched. 

The line is in the process of being disabled. 
For example, if a STOP_LINE were being sent 
to a line, the status for the line would be 
DOWNING. Once the command executed, the 
status changes to DISABLED. 

In process of being enabled. Periodic retry of 
communications on a disabled line have 
succeeded. 

Auto recognition of speed, parity, and/or 
character code set is taking place. 

The controlling TIP for the line is being 
loaded. 



Type of line, which may be either switched (swt.) or dedicated 
(ded.). 

The name of the TIP that is controlling the communication line. 

Communication line speed in bits per second. 

The physical name of the LIM/Port used for the communication 
line. 
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The expanded line status display describes the devices for each line as follows. 



line name 
tip name 
device name 
address 

state 



The logical name of the communication line. 

The name of the controlling TIP. 

The logical name of the device. 

The physical address (cluster address/device address) of the 
device. 

The state of the device, as follows: 



active 
1 nact 1 ve 
down 
stopped 

not ready 



Communications with the device are active. 

Communications with the device are inactive. 

The device is down. 

Data transfer for the device has been stopped 
by the terminal user. 

The device is not ready. 



The detail line status display describes the active connections for the interactive and 
batch devices for each line as follows. 



device name 
working connection 
service name 

connection type 
Input state 



The logical name of the device. 

Indicated by a > character preceding its status. 

The logical name of the service to which the device is currently 
connected. $CDCNET_COMMAND is displayed if no connections 
are present. 

Type of terminal connection for the line, which may be 
INTERACTIVE or BATCH. 

The input state for the connection, which may be: 



active 
off 

flow cntl 

sync 



Input is active. 

Input is off; the connection is not the working 
connection. 

Transmission of further input stopped due to 
network flow control. 

Input interrupted (for example, a user has 
entered an interrupt sequence). 
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output state 



The output state for the connection, which may be: 



send 
hold 

discard 
interrupt 
flow cntl 

sync 

output queued 



Output sent to the device as received. 

Output held by the network until reenabled by 
the user. 

Output discarded until reenabled by the user. 

Output aborted (interrupted) by the user. 

Transmission of further output stopped due to 
network flow control. 

Output interrupted. 

The number of messages / number of bytes 
queued for output. 
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DISPLAY__LLC_2 ..STATUS (DISL2S) 
NETOU Command 

Purpose Displays the operating status of the Logical Link Control 2 (LLC 2) entity 
by displaying the status of specific connections serviced by LLC 2. 

Format DISPLAY_LLC _2 .STATUS 

Parameters None. 

Responses The following header precedes the status display (see example). 

LLC 2 Status 

Within the status display, the following response is inserted if the SAP is 
open and has no connections established. 

No connections established for this SAP 



Examples 



display_llc_2_status 














LLC 2 Status 














SAP name = CONS 














Connection CEPID 
State 


User 

CEPID 


Peer MAC 
Address 


V(R) 


V(S) 


Queue 

ACK / 


size 
Transmit 


NORMAL 001798AO 
AWAIT.REJECT 001539FO 
D.CONN 0O166BE0 


001786A0 
00122890 
00141056 


080025300674 
080025100080 
080025300335 


001 
068 
000 


115 
033 
000 


016 
002 

ooo 


0001 
0005 
0000 
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LLC 2 Status Display Description 

The DISL2S command displays the following operating status. 

connection state Operational state of the LLC 2 connection which may be: 

SETUP A connection request has been sent for the 

connection. 

NORMAL A data transfer state (as are the next five 

states). 

BUSY The local system is buffer congested. 

REJECT Out-of-sequence data has been received from 

the peer. 

AWAIT One or more timers have expired on this 

connection. 

AWAIT.REJECT Combination of states AWAIT and REJECT. 

D_CONN The connection is being disconnected. 

RESET The connection is being resynchronized. 

ERROR The connection is recovering from a locally 

detected protocol error. 

Address of the Connection End Point Identifier table. 

Address of the user Connection End Point Identifier table. 

The Medium Access Control (MAC) address associated with the 
peer. 

The LLC 2 receive state variable (next sequence number 
expected). 

The LLC 2 send state variable (next sequence number assigned). 

The number of messages in the acknowledge queue. 



CEPID 

User CEPID 

Peer MAC address 

V(R) 

V(S) 

Queue size ACK 



Queue size transmi- The number of messages in the transmit queue. 
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DISPLAY_LLC _2 .TRUNK .OPTIONS (DISL2TO) 
NETOU Command 

Purpose Displays the configuration of LLC 2 trunks. An LLC 2 trunk is identified 

by its trunk name. If a trunk name is not entered, the configuration of all 
LLC 2 trunks defined for the system is displayed. 

Format DISPLAY.LLC _2 JTRUNK ..OPTIONS 

TRUNK _NAME = list l7.15 of name 
DISPLAY JOPTION = list 1..10 of key 

Parameters TRUNK _NAME (TN) 

Specifies the logical name of an LLC 2 trunk assigned by a DEFINE _ 
LLC_2_TRUNK command. 

DISPLAY JOPTION (DO) 

Specifies one or more of the trunk attributes for display. The default is 
ALL. The allowed keyword values are: 

ETHER_TRUNK_NAME (ETN) 
PEER_MAC_ADDRESS (PMA) 
PEER_LSAP_ADDRESS (PLA) 
TRUNK _NAME (TN) 
MODE (M) 

RECEIVE _WINDOW_SIZE (RWS) 
TRANSMIT_WINDOW_SIZE (TWS) 
ACKNOWLEDGEMENTJTIMER (AT) 
POLL_BIT_TIMER (PBT) 
REJECTJTIMER (RT) 
BUSY_STATE_TIMER (BST) 
ALL 

Responses The following header precedes the status display (see example): 
LLC 2 Trunk options 

Within the options display, the following responses are inserted if a 
TRUNK _NAME is not defined or is not an LLC 2 trunk, or if no LLC 2 
trunks are defined. 

Trunk <name> is not defined. 

Trunk <name> is not an X.25 trunk. 

No X.25 trunks are defined for this system. 
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Examples d1splay_llc_2_trunk_opt1ons trunk_name=pdn_relay_dev1ce 

LLC 2 Trunk options 

ether_trunk_name = BACKBONE 
peer„mac_address = 0800253006B8 
peer_lsap_address = FE(16) 
trunk_name = PDN_RELAY_DEVICE 
mode « RESTART 
receive_w1ndow_s1ze =16 
transm1t_window_s1ze = 16 
acknowledgement^ imer = 3000 
pol1_b1t_timep = 3000 
reject_t1mer = 5000 
busy_state_t1mer ■ 10000 
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DISPLAYJLOGICAL_NAMES (DISLN) 
NETOU Command 



Purpose 



Format 



Displays the logical names for trunks, network solutions, communication 
lines, gateways, NP interface definitions, X.25 interface definitions, Unit 
Record Interface lines, batch I/O stations, Network Transfer Facility (NTF) 
remote systems, NTF batch streams, devices, and TIPs for a specified DI. 

DISPLAY.LOGICAL _NAMES 

DISPLAY JOPTION = list of keyword value 



Parameters DISPLAY JOPTION (DO) 

Displays one or more types of logical names for display. The following 
keyword values are allowed. 

TRUNK _NAME (TN) 
NETWORK _NAME (NN) 
LINE_NAME (LN) 
TIP_NAME (TIP) 
ALL (A) 

Default is ALL. 

Responses The following header precedes the system logical names display (see 
example). 

System logical names 

Examples display_logical_names 

System logical names 

Trunk_names 
ETHER.ESCI1 

Network_names 
TDI.TRUNK 



L1ne_names 

ENGINEERING_PORT_1 

ENGINEERING_PORT_3 

ENGINEERING.P0RT.5 

ENGINEERING_P0RT_7 

ENGINEERING.P0RT.9 

ENGINEERING_PORT.11 

ENGINEERING_P0RT_13 

ENGINEERING_P0RT_15 

T1p_names 
ASYNCTIP 



ENGINEERING. 
ENGINEERING. 
ENGINEERING. 
ENGINEERING. 
ENGINEERING. 
ENGINEERING. 
ENGINEERING. 
ENGINEERING. 



.PORT.2 
.P0RT_4 
.PORT_6 
.PORT_8 
.PORT. 10 
.PORT. 12 
.P0RT.14 
.PORT. 16 
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DISPLAY_MEMORY (DISM) 
NETOU Command 

Purpose Displays the contents of memory, beginning at the machine address you 

specify. The amount of memory displayed is the product of two parameters, 
BYTE_COUNT and REPEAT_COUNT that you specify. The command also 
returns the module name and offset in the module of the displayed address, 
if the starting address is within a section of a module. The memory 
display is in hexadecimal and ASCII representation. 

Format DISPLAY_MEMORY 

ADDRESS = O..OFFFFFF(16) or name 
BYTEJOFFSET = 0..65535 
BYTEJCOUNT = 1..4096 
REPEAT JCOUNT = 1..4096 

Parameters ADDRESS (A) 

Location of the first memory byte you want to display. Enter the name of 
the module, or the entry point if you want to display memory within a 
module; otherwise, enter the numeric address of the starting memory 
location you want to display. This value is considered the base address. 

BYTEJOFFSET (BO) 

Provides the offset to the base address given by the address parameter. 
Add the value of the BYTE ..OFFSET parameter to the address parameter 
value, forming the new address. Default value is (zero). 

BYTEJCOUNT (BC) 

Displays the number of bytes in each line. Use with the REPEAT_COUNT 
parameter (described next) to specify the number of bytes to display. 
Default number of bytes to display is 1 (one). Default number of bytes per 
line is 16. 

REPEAT JCOUNT (RC) 

Displays the number of lines selected. Use with BYTE_COUNT to specify 
the number of bytes to display. The default value when calculating the 
number of bytes to display is 1. 

The number of lines you display match the specified REPEAT_COUNT, 
only if BYTE_COUNT is greater than 1 or less than or equal to 16. If 
BYTE_COUNT is 1 or greater than 16, the number of lines displayed is 
the number required to display BYTE_COUNT times the REPEAT. 
COUNT number of bytes at 16 bytes per line. 
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Responses The following header precedes the display of memory (see example). 

Memory displayed 

The following responses may appear when a failure occurs. 

-WARNING- Some memory to be displayed is not in a valid address 

range. 

Displayed memory length truncated. 

-WARNING- Bus error encountered, display terminated. 

-WARNING- Too much memory was requested for display. 

-ERROR- First address to be displayed is not in a valid address range. 

-ERROR- Address xxx not found. 

Examples d1splay_memory address*system_data repeat .count =128 

1 1808C SYSTEM_AUDITS+2AA 

11808C 0006 4054 495F 3833 

11809C 2020 2020 2020 2020 

1180AC 2000 0000 0015 0041 

1180BC 0007 0024 0009 0006 

1180CC 2018 1348 9600 0000 

1180DC 0000 0000 0100 0023 

1180EC 5423 004E 904F EF00 

1180FC 0000 0000 0046 6570 



2020 2020 2020 2020 


MTI_83 


2020 2020 2020 2020 




0036 000E 0007 000C 


A 6 


0006 03C4 3E7C 8611 


$ > 


0001 0800 2510 0083 


H % 


200A 2343 4443 4E45 


# #CDCNE 


1E4E 5E4E 754E 804C 


T# N N'NuN L 


7462 4245 4749 4E5F 


FeptbBEGIN. 
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DISPLAYJSAME _RESOLVER .STATUS (DISNRS) 
NETOU Command 

Purpose Displays the current Domain Name Resolver (DNR) status. 

Format DISPLAY_NAME _RESOLVER ^STATUS 

Parameters None. 

Responses display _name _resolver _status complete 

-ERROR— Domain Name Resolver is not defined. 

Examples di spl ay_name_resol ver .status 

TCP/IP Domain Name Resolver Status 

Number of requests timed out = 10 
Total number of requests Issued = 100 
Maximum query retry count = 5 

Timeout value = 10 

Current Default. Domain = SVL.CDC.COM 

Name Server Addresses = 192.12.251.68 

192.12.251.35 
192.12.251.33 
d1splay_name_resol ver .status complete. 
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DISPLAY _NET_DELAY_MEASUREMENT (DISNDM) 
NETOU Command 

Purpose Displays the current measurement parameters and the last calculated 
average delay time for a running measurement. 

Format DISPLAY_NET_DELAY_MEASUREMENT 

DESTINATION _SYSTEM = list of name or ALL 

Parameters DESTINATION ^SYSTEM (DS) 

Specifies the system name, which the network delay measurement is to be 
made, from the source (originating) system. This is the name as designated 
by the DESTINATION .SYSTEM parameter on the START_NET_DELAY_ 
MEASUREMENT command. 

Default is ALL. 

Responses The following header precedes the display response (see example). 

Network Delay Measures: 

The following messages indicate a failure. 

-ERROR- Network Delay Measurement to < destination _system> is 
not active. 

-ERROR- System < destination _system> is unknown. 

-ERROR- Destination system < destination _system> is not a 
CDCNET OSI system. 

-ERROR- No Active Measurements Pound. 

Examples senc 'display„net_delay_measurement dest1nat1on_system=nd1_d2. . 
dtt=450 1m1=15' s=md1_a1 

FROM MDI_A1 
Network Delay Measures: 

To NDI_1 
Delay_t1me_threshold (msec.) ■= 450 
Average_only ■ NO 
Measurements = CONTINUOUS 
Messages_per .measurement = 25 
Measurement.prloMty ■ INTERACTIVE 
Inter_measurement_lnterval (minutes) » 15 
Error .threshold ■ 1 
Message. timeout (seconds) = 120 

Measurements completed - 12 
Last delay time average (msec.) - 47 
at 13:43:22 on 01/16/90 
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DISPLAY_NETWORK_STATUS (DISNS) 
NETOU Command 

Purpose Displays the status of network solutions connected to a DI. The command 

returns status for specific network solutions, or, if you do not specify a 
network name status of all network solutions connected to the DI. Network 
status displays are described following the command examples. 

Format DISPLAY_NETWORK _STATUS 

NETWORK _NAME = list 1..15 of name 

Parameters NETWORK JVAME (NN) 

Logical name of a network solution. You may specify one name or a list of 
names. Default is a status display of all network solutions connected to the 
DI. 

Responses The following header precedes the network status display (see examples). 

Network Status 

Within the status display, the following response is inserted if a network 
solution name is not defined in the DI's logical configuration. 

Network name <name> not defined. 

No network solutions defined. No network status to report. 

Examples The following example displays the network status for ESCI. 

d1splay_network_status 

Network Status 

network_name ■ ESCI_NET 

network_type ■ ESCI 

network.id = 00000001(16) 

network_status = active 

network_cost - 000A(16) 

trunk_name = ESCI.TRUNK 

trunk.status » up 

number of trunk transit ionsin the last 30 minutes = 

devlce.name = $ESCI6 

average time network is congested ■ % 

date and time network last became active - 88/03/13 08.04.01 
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The following example displays the network status with an ICA. 
d 1 sp 1 ay_net wop k_st at us 

Network Status 

network.name = ICA_IEI_NET 

network_type = Ethernet 

network_1d = 00000001(16) 

network_status * active 

network_cost * 0064(16) 

trunk_narae * IEI_TRUNK 

trunk_status = up 

number of trunk transitions In the last 30 minutes = 

dev1ce_name = $ICA_IEI 

average time network is congested = X 

date and time network last became active = 88/03/13 08.04.01 

The following example displays the network status for HDLC. 

d1splay_network_status 

Network Status 

network_name = HDLC_NET 

network_type = HDLC 

network_1d = 000OBABA(16) 

network_status « active 

network.cost = 037D(16) 

trunk_name = HDLC_TRUNK_a 

trunk_status = up 

number of trunk transitions In the last 30 minutes = 

dev1ce_name = $LIM0_PORT0 

trunk_name = HDLC_TRUNK_B 

trunk.status = up 

number of trunk transitions in the last 30 minutes = 1 

device.name = $LIM0_PORT1 

average time network 1s congested = % 

date and time network last became active =• 88/03/13 08.04.01 
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Network Status Display Description 

The network status display includes the following information. 
network_name The logical name of network solution, 

network.type Type of network solution, such as ESCI (Ethernet), 

net work. Id Network ID for the network solution. 



network_status 



cost 



Operational status of the network. Possible values for status 
include the following: 



configured 



enabled 



active 



congested 



loading remote 



Network solution is defined, but not in use by 
the communications system. 

Network solution is in use by the CDCNET 
communications system but communications are 
not being carried on. This occurs when the 
network solution was in use, but is no longer. 
The operator may have stopped the network, or 
the other side of an HDLC or X.25 connection 
stopped communicating. 

Network solution is active, and communications 
are being carried over the network. Link and 
network protocols are being exchanged. 

Network solution is active, but the depth of the 
transmit queue (the number of messages being 
sent from the DD is greater than the congestion 
threshold established on the configuration 
command that configured the network solution. 
(See the CONGESTED .THRESHOLD parameter 
on the DEFINE _xxxx_NET command in this 
manual for more information on the congestion 
threshold concept). 

Network solution is being used exclusively to 
load a DI system connected through the network. 
Only HDLC networks return this state. 



trunk_name 



The routing cost assigned to the network solution. This is a 
relative measure that is determined from a routing algorithm 
created and maintained by the Routing Management Entity in the 
DI. Cost may change depending upon the amount of traffic on the 
network solution, the state of the network solution, and other 
factors. 

The name assigned to the trunk(s) to which the network solution 
is connected. 
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trunk_status 



Operational status of the trunk. Possible values include the 
following: 



up 



down 



trunk.status 
(HDLC only) 



Active communications are being carried over 
the trunk. 

Something is physically wrong with the trunk. 
Usually this indicates a hardware fault in the 
trunk's interface. This also may indicate an 
ESCI trunk defined on an ESCI card with the 
Ethernet cable disconnected. 

Operational trunk status for HDLC only. Possible values are: 



up for remote 
load 

down — trunk 
inoperative 

down — remote 
disconnect 



down — protocol 
timeout 



down — trunk 
unstable 



enabled 



The trunk is currently being used to remotely 
load a DI over the trunk. 

Too many transmission errors are occurring on 
the physical line associated with the trunk. 

The trunk interface has received a disconnect 
request from the peer at the other end of the 
trunk. 

The HDLC trunk interface at this end of the 
trunk has not received anything from the peer 
at the other side of the trunk within the 
protocol timeout period. 

The HDLC trunk has gone into an inoperable 
state more than 3 times in the past 5 minutes, 
or 6 times in the last 30 minutes. The trunk 
has been taken down for the time interval 
specified on the DEFHT commands UTDT 
parameter. 

The trunk has been idled by DI software. This 
may occur when a rotary network is used to 
remote load a DI. Only one trunk from the 
rotary network is used to do the loading;, the 
remaining trunks are put into enabled state 
until the remote loading has completed. 
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number of trunk 
transitions In 
last N minutes 

devlce_name 



average time 
network is 
congested 

last operational 
transition 



The number of times trunk status has changed from active to 
inactive or inactive to active in the past N minutes. 



The physical name of the interface board in the DI to which the 
network solution is connected. For Ethernet networks, the board 
type is ESCI. For channel networks, the board type is MCI or 
ICA. For X.25 networks, the board type is CIM. 

The percent of time the network is congested. 



The date and time operational state of network last changed. 
Displays either the date and time the network last became active, 
or the date and time the network was last active. Date and time 
in YY/MM/DD HH.MM.SS format. 
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DISPLAY_NON __CDC .ADDRESS _PREFIX (DISNCAP) 
NETOU Command 

Purpose Displays one or more previously configured address prefixes of 

non-CDCNET NSAP addresses and related next hop information. 

The command does not display the next hop information obtained from the 
ES-IS routing protocol. 

Format DISPLAY_NON _CDC ..ADDRESS .PREFIX 

ADDRESS _PREFIX = list 1..10~of string 2..40 or ALL 

Parameters ADDRESS _J>REFIX (AP) 

Displays the address prefix of non-Control Data NSAP addresses. Enter the 
address prefix in hexadecimal digits, unless you specify the keyword ALL. 
ALL displays all previously configured address prefixes. The parameter 
default is ALL. 

Responses The following response is displayed if no address prefix has been previously 
configured or ES-IS routing is not defined for the system. 

No non-CDCNET NSAP address prefix is defined. 

ES-IS routing is not defined. 

The following response is displayed if ES-IS routing is not defined for the 
system. 

ES-IS routing is not defined. 

The following response is displayed if a requested address prefix was not 
previously configured. 

The NonCDCNET NSAP address prefix < address _prefix> is not 
defined. 

The following response is displayed for each value of the address _prefix 
parameter that contains a nonhexadecimal character. 

The NonCDCNET NSAP address prefix (address .prefix) contains 
nonhexadecimal characters. 

The following response is displayed for each value of the address-prefix 
parameter containing an odd number of digits. 

The NonCDCNET NSAP address prefix < address-prefix > contains an 
odd number of digits. 

The address prefix and the next hop (if defined) is displayed for each 
requested address prefix which does not contain nonhexadecimal characters, 
contains an even number of digits, and has been configured. See the 
example for the format of this display. 
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Examples d 1 sp 1 ay_non_cdc_address_pref 1 x 

NonCDCNET NSAP ADDRESS PREFIXES 

NonCDCNET NSAP address prefix 
044723 

047724 

04470053 

044EFAAA 



Subnet ID Next Hop SNPA 
0001 080027 1000EE 

0001 080027100123 

0002 080028 1000CC 
0001 0800271 000 AA 
Not Specified 



di spl ay_non_cdc_address_pref 1 x address jar ef 1 x= ' OOagef ' 

The NonCDCNET NSAP address prefix OOagef contains 
non-hexadecimal characters. 



d1 sp 1 ay_non_cdc_address_pr ef 1 x ap= ' OOacOf ' 

The NonCDCNET NSAP address prefix OOacOf Is not 
defined. 
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DISPLAY.NON .CDC .ROUTING _ENTRY (DISNCRE) 
NETOU Command 



Purpose 



Format 



Parameters 



Responses 



Display previously configured routing entries for one or more non-CDCNET 
NSAP address prefixes. This command does not display the routing 
information obtained via the ES-IS routing protocol. 

For this release, this command displays only the routing entries explicitly 
configured via the ADDNCRE command in the system where the display 
command is being executed. 

DISPLAY_NON_CDC .ROUTING ENTRY 

ADDRESS JPREFIX = list 1..10 of string 2..40 or ALL 

ADDRESS PREFIX (AP) 

Specifies the address prefix of non-CDCNET NSAP addresses for the 
routing entry to be displayed. The elements of each string defining an 
address prefix must be hexadecimal digits, unless ALL is specified. Default 
is ALL, which displays all previously configured routing entries. 

The following response is generated if no routing entry has been 
configured. 

No routing entry for any NonCDCNET NSAP address is defined. 

The following response is generated if a routing entry has not been 
configured for the requested address prefix. 

A routing entry for the NonCDCNET NSAP address prefix < address 
prefix > is not defined. 

The following response is generated for each value of the address _prefix 
parameter which contains a non-hexadecimal character. 

The NonCDCNET NSAP address prefix < address _prefix> contains 
non-hexadecimal characters. 

The following response is generated for each value of the address .prefix 
parameter which contains an odd number of digits. 

The NonCDCNET NSAP address prefix < address .prefix > contains an 
odd number of digits. 

For each requested address prefix which contains an even number of 
hexadecimal digits and for which a routing entry has been configured, the 
next hop trunk and SNPA address are displayed (see the example for the 
format). 
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Examples display _non_cdc_rout ing.entry 

CDCNET BOUNDARY SYSTEM NON-CDC ROUTING ENTRIES 



NSAP address prefix 



Next hop trunk 

Next hop SNPA address 

Distribute 

NSAP address prefix 

Next hop trunk 

Next hop SNPA address 

Distribute 

NSAP address prefix 
Next hop trunk 
Next hop SNPA address 
Distribute 



080027 1000EE334567 
00470008400 1BC56 
082345F10A 
Ether _trunk_one 
082005470001 
TRUE 

034427 1000EE33 
O324AA00CD 
Ether .trunk _two 
0320054700AC 
FALSE 

00390001 
X25telenet_one 
032005470099345 
TRUE 



d 1 sp 1 ay _non_cde_rout ing.ent ry ap= ' 00 AGEF ' 

The NonCDCNET NSAP address prefix 00AGEF contains non-hexadecimal characters. 

display _non_cdc_address_pref ix ap='OOAC0F' 

Routing entry for the NonCDCNET NSAP address prefix O0AC0F is not defined. 
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DISPLAY_NP__GW_OPTIONS (DISNGO) 
NETOU Command 

Purpose Displays the configuration of an application-to-application (A-to-A) NP 

transparent gateway to a NOS host. The display returns the title or titles 
registered by the gateway in the catenet and the definition required for 
A-to-A connections to a NOS host. 

Format DISPLAY_NP_GW OPTIONS 

GATEWAY J1AME = list 1..15 of name 
DISPLAY JOPTION = list of keyword value 

Parameters GATEWAYJNAME (GN) 

Displays the logical name of one or more NP transparent gateway 
definitions. If GATEWAY_NAME is not specified, the configuration of all 
NP transparent gateways defined for the system is displayed. 

DISPLAY JOPTION (DO) 

Displays one or more of the gateway attributes. These attributes are 
defined by parameters on the DEFINE _NP_GW command that configured 
the line. For more information on these parameters, see the DEFINE _NP 
GW command description in this manual. The allowed keyword values are" 

GATEWAY_NAME (GN) 

TRUNK _NAME (TN) 

NOS .PROTOCOL _ID (NPI) 

CDCNET_PROTOCOL_ID (CPI) . 

NOS_DHOST_NUMBER (NDN) 

TITLE (T) 

ALL (A) 

Default is ALL. 

Responses The following header is followed by the display of options (see example). 

Network Products Gateway options 

Within the options display, the following response appears if the 
GATEWAY_NAME was not previously defined. 

NP gateway <name> is not defined. 

Within the options display, the following response appears if no NP 
applications are defined in the system. 

No NP gateways are defined for this system. 
Examples d1splay_np_gw_opt1ons 

Network Products Gateway options 

gateway_name = A_TO_A 

trunk_name = 907_CHANNEL_170 

nos.protoco1._id = (C0(16),C1(16)) 

cdcnet_protocol_ld ■ (C4(16)) 

nos.dhost .number - (1A(16)) 

title - ( 109_A_TO_A, 109.APPLICATIOM) 
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DISPLAY_NP_INTERFACE .OPTIONS (DISNIO) 
NETOU Command 

Purpose Displays the network products configuration parameters for the block 
protocol (BIP and SVM) interface to a NOS system. 

Format DISPLAY_NP_INTERFACE .OPTIONS 

INTERFACE _NAME = name 

DISPLAY JOPTION = list of keyword value 

Parameters INTERFACE _NAME (IN) 

Displays the logical name of the NP interface. If you do not specify an 
INTERFACE _NAME, the command displays all defined NP interfaces. 

DISPLAY JOPTION (DO) 

Displays one or more of the interface attributes. These attributes are 
defined by parameters on the DEFINE _NP_INTERFACE command that 
configured the line. For more information on these parameters, see the 
DEFINE _NP_INTERFACE command description in this manual. 

TRUNK_NAME (TN) 
MDI_NODE (MN) 
COUPLER _NODE (CN) 
INTERFACE _NAME (IN) 
CONGESTED .THRESHOLD (CT) 
ALL (A) 

Default is ALL. 

Responses The following header precedes the display of options (see example). 

Network Products Interface options 

Within the options display, the following response appears if the 
INTERFACE _NAME was not previously defined. 

NP interface < interface _name> is not defined. 

Within the options display, the following response appears if no NP 
interfaces are defined in the system. 

No NP interfaces are defined for this system. 

Examples d1 sp 1 ay_np_1nter f ace.opt Ions 

Network Products Interface options 
trunk.name ■= 907_CHANNEL_170 
mdl.node = 03(16) 
coupler _node - 19(16) 
1nterface_name « C170_COUPLER_1 
congested_threshold » 40 
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DISPLAY_OPERATORJSUPPORT (DISOS) (NOS MDI Only) 
NETOU Command y 



Purpose 



Format 



Parameters 



Displays the user names of the operators currently logged into the NOS 
host and into NETOU. The display also indicates the status of the 
connection to the host through a specified trunk. If the status is DOWN, 
the connection is down. If the status is ACTIVE, the connection is up and 
in use. 

DISPLAY_OPERATOR SUPPORT 

TRUNK_NAME = name 

TRUNK _NAME (TN) 

The trunk name of the logical link for which operator support is to be 
displayed. If this parameter is not specified, the default trunk is used. The 
default trunk name is specified by a DEFINE _SYSTEM command. If a 
default channel trunk is not specified on the DEFINE .SYSTEM command, 
the channel over which the MDI/MTI was loaded is the default channel 
trunk. If the MDI/MTI was not loaded over a channel and no default 
channel trunk is specified on a DEFINE _SYSTEM command, then no 
default channel trunk exists. 

Responses The following header precedes the DISOS display (see example). 

Operators supported for trunk <name>. Connection is < state >. 

Within the status display, the following response appears if the operator 
support was not defined for a specified trunk. 

Operator Support is not defined for trunk <name>. 

Within the status display, the following response appears if no operator 
support was defined for the system. 

Operator Support is not defined for the system. 

Within the status display, the following response appears if no operators 
are logged in for the specified system. 

-None- replaces the list of operator identifiers if no operators are logged 
in. 

Examples dlsplay.operator .support 

Operators supported for c170_trunk_03. Connection 1s active. 

open 

oper2 

oper3 



opern 
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DISPLAY_OSI _TRANSPORT_OPTIONS (DISOTO) 
NETOU Command 

Purpose Displays the current value of the OSI Transport options. These values are 
either the CDCNET defaults or the values specified by the CHANGE _ 
OSI .TRANSPORT command. 

Format DISPLAY_OSI _TRANSPORT_OPTIONS 

DISPLAY JOPTION = list of keyword value 

Parameters DISPLAY JOPTION (DO) 

Displays one or more of the OSI transport attributes. These attributes are 
defined by parameters on the CHAOT command. For more information on 
these parameters, see the CHAOT command description in this manual. 
The allowed keyword values are: 

CHECKSUMMING (C) 
ACKNOWLEDGE .TIMER (AT) 
MAXIMUM _WINDOW_SIZE (MWS) 
MAXIMUM .CONNECTIONS (MC) 
ENABLE _OVER_CONS (EOC) 
CONS_USER_DATA (CUD) 
ALL (A) 

Default is ALL. 
Responses The following header precedes the options display (see example). 

OSI Transport options 
Examples di splay _osi_transport_opt Ions 



OSI Transport options 
Checksumming = FALSE 
Acknowledge timer = 5 
Maximum window size » 16 
Maximum connections - INFINITE 
Enable_over_cons - TRUE 
Cons_user.dat a = NONE 
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DISPLAY_OSI_TRANSPORT STATUS (DISOTS) 
NETOU Command 



Purpose 



Format 



Parameters 



Displays the operating status of various elements of the OSI Transport, 
including the status of the specific service access points (SAPs) and of the 
specific connections serviced by the OSI Transport. 

SAPs and connections are specified by their Transport Selectors and 
references (these values are displayed in summary and expanded status 
displays). If you specify both transport selectors and references, the 
command returns status for all specified transport selectors and all 
specified references. 

DISPLAY_OSI _TRANSPORT_STATUS 

SAP = list 1..15 of O..OFFFF(16) 
REFERENCE = list 1. .15 of 1..0FFFF(16) 
DISPLAY JOPTION = keyword value 

SAP (S) 

Displays the transport service access point (TSAP) selector of the SAP 
whose status is to be displayed. 

REFERENCE (R) 

Displays the identifier of the connection whose status is to be displayed. 

DISPLAY JOPTION (DO) 

Displays the level of status for the general status. The parameter is 
ignored if you specify either a SAP identifier or reference. The following 
values are allowed for the DISPLAY_OPTION. 



Keyword Value 



Description 



SUMMARY (S) 
EXPANDED (E) 

Default is SUMMARY. 



Selects the summary status display. 

Selects more detailed transport status. Provides 
additional information about specific SAPs. 



Responses The following header precedes the status display (see example). 
OSI Transport Status 

Within the status display, you receive the following responses if a SAP 
identifier or reference is unknown, or if a SAP has no connections 
established. 

SAP <0..0fHIU6)> unknown 

Reference <0..0f£ff(16)> unknown 

No connections established for this SAP 
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Examples This command returns a summary display of the OSI transport. 
display_osi_transport_status 

OSI Transport Status 
number of SAPs = 2 
number of class connections = 2 
number of class 2 connections = 
number of class 4 connections » 8 
number transport congested » 
number user congested - 
number Incoming connections = 4 
number outgoing connections = 4 

This command returns an expanded status display of the OSI transport. 

d1splay_os1_transport_status display_opt1on=e 

OSI Transport Status 
number of SAPs = 2 
number of class connections = 2 
number of class 2 connections * 
number of class 4 connections = 8 
number transport congested = 
number user congested - 
number Incoming connections = 4 
number outgoing connections = 4 



SAP 


SAP name 


number of 


transport 


user 






connections 


congested 


congested 


1046(16) 


IND_FILE_ACCESS 


2 








1B3C(16) 


IVT_GATEWAY 


2 


1 






This command returns the status of the specified TSAP selector, 
di splay _os1_transport_status sap=( 1046( 16) . 1b3c( 16) ) 

OSI Transport Status 

SAP 1046(16) 

reference = 47AC(16) peer reference « 0224(16) 

peer NSAP address = 000000020800252A022313FE 
peer TSAP selector = 0973(16) 

reference ■ 2391(16) peer reference - 6363(16) 

peer NSAP address - 000000080800252A0653739E 
peer TSAP selector - 0222(16) 

SAP 1B3C06) 

This SAP closed, no new connection may be established with this SAP. 

reference ■ 8561(16) peer reference - 6458(16) 

peer NSAP address - 000000080800252A06535473 
peer TSAP selector » 0630(16) 
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This command displays the status of the specified SAP reference identifier 
for a class 4 connection over CLNS. 

display _os i.transport.status ref erence«47ac( 16) 
OSI Transport Status 

reference = 47AC(16). Transport class 4 connection over CLNS 
connection state = open 
connection table address = 110C28O6) 
user connection Identifier = 142042(16) 
Transport selector = 1046(16) 
network service priority = 4 

next assignable transmit' sequence number » 00000012(16) 
next expected receive sequence number = 000002BAO6) 
credits granted to the peer = 3 credits granted from trie peer = 16 
average round trip 1s = 375ms length data receive queue » 
length normal data queue = length normal ack queue ■= 1 
local acknowledgement timer = 5000ms delayed acknowledgements = 1 
connection has no expedited data outstanding 
connection is not user congested 
connection is not transport congested 
this is an incoming connection 
Transport Pulls are checksummed 

This command displays the status of the specified SAP reference identifier 
for a class connection over CLNS. 

display_osi_transport_status reference=8561(16) 
OSI Transport Status 

reference = 8561(16), Transport class connection over CONS 
connection state = open 
connection table address = 120DE0O6) 
user connection Identifier = 104064(16) 
Transport selector = 1B3C(16) 
network service priority = 4 
connection is not user congested 
connection is not transport congested 
this is an incoming connection 
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Summary Transport Status Display Description 

The summary transport status provides the following information for each OSI 
transport. This display is the default display. 



number of SAPs 
number of connections 
number transport congested 

number user congested 

number Incoming connections 

number outgoing connections 



The number of SAPs associated with the OSI transport. 

The number of connections. 

The number of connections on which the transport 
window has closed. 

The number of connections on which the user requested 
a stop to message indications. 

The number of connections inbound to the OSI 
transport. 

The number of connections outbound from the OSI 
transport. 



Expanded Transport Status Display 

The expanded transport status display returns the following information 



number of SAPs 
number of connections 
number transport congested 

number user congested 

number Incoming connections 

number outgoing connections 

SAP Id 

SAP name 

number of connections 
transport congested 

user congested 



The number of SAPs associated with the OSI transport. 

The number of connections. 

The number of connections on which the transport 
window has closed. 

The number of connections on which the user requested 
a stop to message indications. 

The number of connections inbound to the OSI 
transport. 

The number of connections outbound from the OSI 
transport. 

The TSAP Selector (SAP identifier) of each SAP 
serviced by the OSI transport. 

The name associated with each SAP serviced by the OSI 
transport. 

The number of connections in each SAP. 

The number of connections for which the transport 
window has closed. 

The number of connections on which the user has 
requested a stop of message indications. 
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Transport Selector Status Display 

The transport selector status display provides the following information about the 
specified service access point identifier (SAP ID). 



SAP status 



reference 



peer reference 



peer NSAP address 



peer TSAP selector 



If the SAP is closed, displays a statement that no new 
connections may be established on the SAP. 

Identifier for connections associated with this particular transport 
selector. 

Identifier for the peer reference associated with this particular 
transport selector. 

Identifies the peer NSAP address for each connection (30-40 
hexadecimal digits). 

Identifies the TSAP selector for each connection (two hexadecimal 
digits). The identifier may be truncated if the transport is 
communicating with a foreign OSI transport implementation. 



Transport Reference Status Display 

The transport reference status display provides the following information about the 
specified connection. 



reference 
protocol stack 
connection state 



Identifies the connection to which the display applies. 

Transport class and network service variant. 

State of the connection, as follows: 

connection request sent A connection request has 

been sent for the identified 
connection. 

Connection request received The connection received a 

connection request. The 
connection is waiting for 
acceptance or rejection 
from the user. 

The user has accepted the 
connection and has sent a 
connect confirm TPDU. The 
user is awaiting 
acknowledge of the connect 
confirm. 

The identified connection is 
open, ready to transmit 
and receive messages. 

The identified connection is 
being disconnected. 



Confirm acknowledge wait 



Open 



Closing 
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Disconnecting The identified connection is 

being disconnected because 
the associated SAP is being 
closed (service shutdown). 

Reference timer wait The connection has no 

more activity. Connection 
waiting for reference tinier 
to expire. 

Displays the following information about the connection: 

• Connection table address 

• User connection identifier 

• Transport selector, which is the identifier of the 
transport selector associated with the SAP 

• Network service priority 

• Next assignable transmit sequence number 

• Next expected receive sequence number 

• Credits granted to the peer 

• Credits granted from the peer 

• Average round trip (in milliseconds) 

• Length data receive queue 

• Length normal data queue 

• Length of normal ACK queue 

• Local acknowledgement timer 

• Delayed acknowledgments 

• Whether there is expedited data outstanding 

• Whether the connection is transport congested 

• Whether the connection is user congested 

• Whether this is an outgoing or incoming connection 

• Whether Transport PDUs are checksummed 
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DISPLAY_OUTCALL _GATEWAY_STATUS (DISOGS) 
NETOU Command 



Purpose 



Displays the configuration of the Outcall Gateway. The display contains a 
header entry that includes the status of the Outcall Gateway itself. 
Following the header entry are one or more Server entries, each describing 
information about the servers associated with a particular title. 

Format DISPLAY_OUTCALL _GATEWAY_STATUS 

Parameters None. 

Responses -INFORMATIVE- Outcall Gateway is not defined. 

Examples dlsplay.outcal l_gateway_status 



Outcal 1 Gateway 
Services 

Registration Title 
Default Inactivity Timer 
Total Server Connections 
Total Client Connections 

Title 

Allowed Access 
Access Status 
Inactivity Timer 
Control Server Port 
Modem Protocol 
Total Server Ports 
Device outcall Servers 
Passthrough Servers 
Idle Message 

Title 

Allowed Access 
Access Status 
Inactivity Timer 
Control Server Port 
Modem Protocol 
Total Server Ports 
Device outcall Servers 
Passthrough Servers 
Idle Message 

Title 

A1 lowed Access 
Access Status 
Inactivity Timer 
Control Server Port 
Modem Protocol 
Total Server Ports 
Device outcall Servers 
Passthrough Servers 
Idle Message 



STARTED 

DEVICE.OUTCALL, PASSTHROUGH 

SOUTCALL 

600 

46 

11 

ARHBE 

PASSTHROUGH 

AVAILABLE 

300 

YES 

NONE 

32 

0/0 (configured/available) 
32/28 (configured/available) 
NONE 

DIALOUT 

DEVICE OUTCALL, PASSTHROUGH 

AVAILABLE. AVAILABLE 

300 

YES 

HAYES 

2 
2/1 (configured/available) 
2/1 (configured/available) 

NONE 

VAX 

DEVICE OUTCALL, PASSTHROUGH 
AVAILABLE, BUSY 
600 
YES 
NONE 
12 

12/6 (configured/available) 
4/0 ( con f i gured/ava i 1 ab 1 e ) 
NONE 
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DISPLAYJPASSTHROUGH_STATUS (DISPS) 
NETOU Command 

Purpose Returns the configuration for the Interactive Passthrough Gateway (IPG) 
and displays the status of all connections the IPG supports. 

NOTE 

In future releases, this command will no longer be supported. You should 
start using the DISPLAY_OUTCALL_GATBWAY_STATUS command as 
soon as possible. 

Format DISPLAY.PASSTHROUGH .STATUS 

Parameters None. 

Responses The response provides five lines of header information about the 

passthrough service, followed by a four-line entry for each unique server 
connected to the IPG. See example of successful status display. 

The header information includes the configured passthrough service title, 
the status of the passthrough service, the value of the default inactivity 
timer and the total number of server and client connections. The total 
number of server connections indicates the number of connections the site 
has configured to connect to this instance of the IPG. The total number of 
client connections indicates the number of server connections in actual use. 

Each server entry identifies a unique server title connected to the IPG. 
Each server entry includes the server title, the inactivity timer for this 
server, the number of server connections represented by the server title 
and the number of clients currently connected to server connections with 
this server title. 

The format of the header and server entries follows. One or more server 
entries may follow a header entry. 



Service Title 

Status 

Default Inactivity Timer 

Total Server Connections 

Total Client Connections 

Server Title 
Inactivity Timer 
Server Connections 
Client Connections 



<DEFPS title > 

< started/stopped > 

<DEFPS inactivity timer value > 

< Total connected Servers > 

< Total connected Clients > 

<DEFPT title 

<DEFPT inactivity timer value > 

< Servers with this title > 

< Clients accessing this title > 



The following reponses is displayed when the service is not defined. 
-ERROR- Passthrough Service not defined. 
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Examples 



display_passthrough_status 



Default Inactivity Timer 


600 


Status 


STARTED 


Service Title 


PASSTHROUGH 


Total Server Connections 


32 


Total Client Connections 


15 


Server Title 


ARHBE 


Inactivity Timer 


300 


Server Connections 


32 


Client Connections 


4 


Server Title 


ARHBE 1 


Inactivity Timer 


300 


Server Connections 


16 


Client Connections 


6 


Server Title 


ARHBE 2 


Inactivity Timer 


600 


Server Connections 


16 


Client Connections 


5 



Passthrough Status Display Description 

The passthrough status display includes the following information about the 
passthrough service: 



Default Inactivity Timer 

Status 

Service Title 

Total Server Connections 

Total Client Connections 



The value of the default inactivity timer. 

The operational status of the passthrough gateway. 

The title of the configured passthrough gateway. 

The total number of connections configured to connect 
to this instance of the gateway. 

The total number of server connections in actual use. 



The display provides the following information about each unique server connected to 
the interactive passthrough gateway: 



Server Title 



Inactivity Timer 



Server Connections 



Client Connections 



The title of the server connected to the IPG, as 
specified in the DEFPT command. 

The value of the inactivity timer for this server, as 
specified in the DEFPT command. 

The number of server connections associated with this 
server title. 

The number of clients currently connected to the 
server connections of this server title. 
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DISPLAY_RECORDER_LOG .GROUP (DISRLG) (NOS MDI Only) 
NETOU Command 



Purpose 



Displays the log groups supported by an Independent Log Management 
Entity (ME) at a NOS MDI or MTI, and the priority of the ME for each 
log group. For this release of CDCNET, only one log group can be defined 
per channel trunk for each NOS MDI or MTI. The display also indicates 
the state of the Independent Log ME connection to the host through the 
channel trunk. The state may be: 



down 



Connection is down. 



Format 



active Connection is up and in use. 

DISPLAY.RECORDER LOG GROUP 

TRUNK_NAME = name 



Parameters TRUNK _NAME (TN) 

The trunk name of the logical link for which the defined recorder log 
group is to be displayed. If trunk name is not specified, the recorder log 
groups defined for all trunks are displayed. 

Responses The following header precedes the display of log groups (see example). 

Recorder Log Groups. 

If no recorder log groups are defined for the DI, or if log groups are not 
defined for a specified trunk, the following appropriate responses replace 
the log group display. 

Recorder log groups are not defined for trunk <name>. 

Recorder log groups are not defined for the system. 

Examples di splay_recorder_log_group 

Recorder Log Groups for trunk $mc14. Connection is active. 
Log Group Priority 

CATENET 1 
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DISPLAY_REMOTE .LOAD .SUPPORT (DISRLS) 
NETOU Command 

Purpose Returns the current configuration and status of the remote load support of 
a system. The returned configuration information includes the values of all 
parameters supported by the DEFINE _REMOTE_LOAD_SUPPORT 
command described in this manual. The returned status information 
includes the status of the load help provided by the remote systems. 

Format DISPLAYJREMOTE _LOAD .SUPPORT 

Parameters None. 

Responses The following header precedes the display (see example). 

Remote Load Support Configuration 

The following response replaces the display if remote load support is not 
defined for the system. 

Remote Load Support is not defined for this system. 

Examples In this example, the Initialization Management Entity is loading or 
dumping a remote system when this command was received. 

di spl ay_remote_load_support 

Remote Load Support Configuration 

priority = 3 concurrent load limit = 4 

restricted networks HDLC_1 

HDLC.2 

Remote Load Support Status 



network name 


remote system 


id 


load status 


ETHERNET. 1 


0B00250A1312 




dumping 




0800250A1313 




loading 


ETHERNET.2 


0800250A1314 




loading 



In this example, the Initialization Management Entity is not loading or 
dumping any system when the command was received. 

d 1 sp 1 ay_r emot e_ 1 oad.suppor t 

Remote Load Support Configuration 

priority = 3 concurrent load limit - 4 

restricted networks HDLC_1 

HDLC_2 

Remote Load Support Status 

At present no remote system is being loaded or dumped. 
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DISPLAYJRIP .SERVICE (DISKS) 
NETOU Command 

Purpose Displays the current configuration of RIP (Routing Information Protocol) 

services. This command displays the RIP service information that was 
configured with ADD_RIP_SERVICE commands. The following information 
is displayed for each IP network that has the RIP service configured: 

• IP Network 

The IP address of the directly connected IP network. 

• Cost 

The value of the TRUNK _COST parameter supplied on the ADD_RIP_ 
SERVICE command. 

• Trusted neighbors 

The IP address of each trusted IP host on this IP network that was 
configured by the TRUSTED_NEIGHBORS parameter. If no IP 
addresses were configured as trusted IP hosts, ALL is displayed. 

• Excluded routes 

The IP address of each network route that was configured by the 
EXCLUDED_ROUTES parameter. If no routes were configured for 
exclusion, NONE is displayed. 

• Included routes 

The IP address of each network route that was configured by the 
INCLUDED_ROUTES parameter. If no routes were configured for 
explicit inclusion, ALL is displayed. 

• ARP routing 

Indicates whether ARP proxy routing is enabled or disabled 

Format DISPLAY_RIP_SERVICE (DISKS) 

Parameters None. 

Responses RIP Configuration Display {Display follows, see example} 

If no RIP services are configured, the following response replaces the 
configuration display: 

No RIP services are defined for this system. 



60000414 D 



DISPLAY Commands 8-89 



DISPLAYJRIP_gERVICE (DISRS) 

Examples display_np_sePvice 

RIP Configuration Display 



IP 

Network 


Mode Cost 


Trusted 

Neighbors 


Excluded 
Routes 


included 
Routes 


ARP 
Rtng. 


129.179.0.0 
129.176.0.0 


BOTH 
RECV 


1 

1 


129.179.0.2 
129.179.0.5 

ALL 


129.178.0.0 

129.176.0.0 

140.150.0.0 

NONE 


ALL 
ALL 


OFF 
OFF 


129.177.0.0 


SEND 


2 


ALL 


NONE 


150.1.0.0 


OFF 
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DISPLAY_SERVICE ..DISPLAY (DISSD) 
NETOU Command 

Purpose Returns a list of interactive service names and their associated status text 

included in the service availability display that is shown when a terminal 
user enters the DISPLAY.SERVICES terminal user command. 

Format DISPLAY.SERVICE .DISPLAY 

SERVICES = list 1..16 of name or ALL 
DISPLAY JOPTION = keyword value 

Parameters SERVICES or SERVICE (S) 

Lists the interactive service names that are to be compared with the list of 
displayable services in the DISPLAY_SERVICES command for the 
terminal. The keyword value ALL specifies all service names. 

DISPLAY JOPTION (DO) 

Displays the detail level of information returned about the displayed 
services. The following keyword values are allowed. 



Responses 



Keyword Value 



Description 



SUMMARY (S) 
EXPANDED (E) 

Default is SUMMARY. 



Selects only the service names for display. 

Selects the service names and accompanying text 
for display. 



Remarks 



The following header precedes a list of service .name, text, down_text, and 
temporary _down _text. 

Services in the displayable list. 

< Service _name > 
T: <text> 

DT: <down_text> 

TDT: < temporary _down_text> 

The following header precedes the services you listed on the command, 
which were not in the displayable services list. 

Services not in the displayable list. 

< Service _name > 

The following header appears if no services were defined. 

—ERROR— No services defined in displayable list. 

Also see the CHANGE .SERVICE .DISPLAY and CHANGE .SERVICE. 
DISPLAY/TEXT commands in this manual. 
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Examples display_service_di splay 

Services In the dlsplayable 11st. 

ARH817 

T: Call x2830 for Information about this service. 

DT: CEs on the machine until the problem is fixed. 

No Estimate at this time. 
TDT: Scheduled down time from 8:00 - 9:00A.M. 

ARH907 

TDT: 907 will go down at 8:00 tonight for maintenance. 
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DISPLAY_SLIP_GW (DISSG) 
NETOU Command 

Purpose Displays the status and entry names for the specified SLIP gateway. 

Format DISPLAY_SLIP_GW 

GATEWAY _NAME = name or ALL 

Parameters GATEWAY_NAME (GW) 

Specifies the logical name of the SLIP gateway as previously defined in a 
DEFINE _SLIP_GW command. If ALL is specified, all SLIP gateways are 
displayed. The default is ALL. 

Responses SLIP gateway <gateway_name>: STATUS = <slip_status> 



Gateway IP Address = <1p_address> 
Subnet Mask Size = <10..30> 
Inactivity Timeout ■ <0..65535> 

Registered titles 

<title1> 

<title2> 



Maximum SLIP Hosts = <1 . . 100> 
Current Connections = <1..100> 
Local Lines Only = <TRUE/FALSE> 



Examples 



SLIP Host Name = <host_name> 
IP address range = <1p_address>. .<ip_address> 
Host name string = <host_name_string> 
Active Connections: 
<ip_address> 

-ERROR— SLIP gateway < gateway _name> is not defined, 
d i sp 1 ay_s l i p_gw gat eway_name-s l i p_gw 

SLIP gateway SLIP.GW: STATUS = RUNNING 

Gateway IP Address - 129.179.052.000 Maximum SLIP Hosts » 100 
Subnet Mask Size « 26 Current Connections ■ 1 

Inactivity Timeout - INFINITE Local Lines Only = FALSE 

Registered titles 
SLIP.3W 

a IP Host Name » SLIPHOST 
IP address range = 129. 179. 052. 062.. 129. 179. 052.062 

Host name string = Attaching sneezy (129.179.052.062) to domain CDCNET via 
s11p.gw (129.179.052.062) 
Active Connections: 
129.179.052.062 



display_sl 1p_gw gateway_name=sl 1p_f f 



—ERROR— SLIP gateway sl1p_ff is not defined. 



finnwuid. f 
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DISPLAY_SNMP_AGENT OPTIONS (DISSAO) 
NETOU Command 

Purpose Displays information configured using commands DEFINE _SNMP_AGENT 
CHANGE _SNMP_AGENT, and ADD_SNMP_COMMUNITY. 

Format DISPLAY_SNMP_AGENT_OPTIONS 

Parameters None. 

Responses The SNMP Agent is not defined. 

SNMP Agent Options 

name = <.... name, up to 255 in length ....> 
contact = <.... contact, up to 255 in length ....> 
location = <.... location, up to 255 in length ....> 
max_pdu_size = xxxx 



Community 

'<commun1ty name>' 
'<community name>' 



IP Address 



Send Traps Access Mode 



xxx. xxx. xxx. xxx <boolean> read-write 
ALL N/A read-only 



Examples display_snmp_agent_opt ions 
SNMP Agent Options 



name = ahse.cdc.com 

contact = John Smith, Network Administrator (612) 555-1212 

location - Building 2, 3rd floor 

max_pdu_s1ze =8192 

Community 



'public' 
'manager 1' 

'manager 2' 



IP Address 


Send Traps 


Access Mode 


ALL 


N/A 


reacf-only 


128.52.1.12 


TRUE 


rear -write 


129.25.42.127 


FALSE 


read-only 


126.45.78.63 


FALSE 


read-only 
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DISPLAYJSOFTWARE .LOAD .STATUS (DISSLS) 
NETOU Command 

Purpose Returns the status of the software modules loaded in a DI. Lists modules 
as either retained or not retained. Retained modules remain loaded when 
not in use. 

Format DISPLAY_SOFTWARE _LOAD ..STATUS 

Parameters None. 

Responses The following header precedes the load status display (see example). 

Software Load Status 

Examples dl splay_sof tware_load_status 



Software Load Status 




name 


retained 


dlagnosticjne 


no 


dvm_mod_snm 


yes 


get_command_f i le 


no 


on_11ne_ loader 


yes 


hardware.scp 


no 



Software Load Status Description 

The software load status display describes each software component as follows. 

name Name of software module. 

retained Indicates whether software module is loaded and kept in the DI. 

Yes Means the module is retained in the DI and is not unloaded, 

even if it is not being used. 

No Means the module is made available for unloading when it is 

no longer being used; the retain flag for the module is not set 
and the module is still in use. 
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DISPLAY_SOURCE_ALARMS (DISSA) 
NETOU Command 

Purpose Displays the list of alarms to be sent to your network operations station 

from a DI and the alarm groups supported by the Log Support Application 
in the DI. 

Format DISPLAY_SOURCE .ALARMS 

Parameters None. 

Responses Source Alarms 

Alarm groups: 

<list of alarm groups > 

Alarm message numbers defined: 

<list of alarm message numbers > 

(If no source alarm groups are defined for the system, the following 
response replaces the source alarm group display): 

No source alarm groups defined. 

(If no source alarm messages are defined, the following response 
replaces the list of alarm message numbers): 

No alarm message numbers defined. 

Examples d 1 sp 1 ay_source_a 1 arms 

Source alarms 
Alarm groups: 

CATENET 
Alarm message numbers defined: 

17.. 82 198 252.. 280 
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DISPLAY_SOURCE_LOG_GROUP (DISSLG) 
NETOU Command 

Purpose Displays the log groups to which the DI belongs and the messages to be 
logged for each group. The messages for each log group comprise the log 
messages reported by a DI. 

Format DISPLAY.SOURCE _LOG _GROUP 

Parameters None. 

Responses Source Log Groups ' 

Log Group <name> 
Log message numbers defined: 
<list of message numbers > 

(Returns a response for each defined log group. If a log group has no 
enabled messages, the following response replaces the message list for the 
group): 

No log message numbers defined. 

(If the DI has no defined source log groups, the following response replaces 
the log group display): 

No source log groups defined. 

Examples display_source_log_group 

Source Log Groups 

Log Group CATENET 

Log message numbers defined: 

1..200 300 350 
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DISPLAY__SYSTEM OPTIONS (DISSO) 
NETOU Command 

Purpose Displays the current value of DI system program attributes. These 

attributes include memory management parameters and system function 
options. This command can be used to determine the location of the 
network's master clock for DIs supported by NOS hosts. 

Format DISPLAY_SYSTEM .OPTIONS 

DISPLAY jOPTION = list of keyword value 

Parameters s DISPLAY JDPTION (DO) 

Specifies one or more of the system attributes for display. These attributes 
are defined by parameters on the DEFINE _SYSTEM command that 
configured this DI. For more information on these parameters, see the 
DEFINE _SYSTEM command description in this manual. Allowed keyword 
values include the following. 

SYSTEM _NAME (SN) 
DATA .BUFFER _SIZE (DBS) 
BUFFER_PERCENTAGE (BP) 
BUFFER _BOUNDARY_PERCENTAGES (BBP) 
MEMORY_BOUNDARY_PERCENTAGES (MBP) 
MEMORY_MANAGER .PERIOD (MMP) 
RESERVED .SYSTEM .SPACE (RSS) 
STANDARD .STACK .SIZE (SSS) 
DEFAULT.CHANNEL .TRUNK (DCT) 
ROUTING.SYSTEM (RS) 
CLOCKING.SYSTEM (CS) 
MAXIMUM .RECOVERIES (MR) 
COMPRESS .DUMP (CD) 
ALL (A) 

Default is ALL. 
Responses The following header precedes the options display (see example). 
System options. 
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Remarks 



DISPLAYJ3YSTEM_0PTI0NS (DISSO) 

For more information on these parameters, see the DEFINE _SYSTEM 
command description in this manual. 



Examples d i sp 1 ay_syst em_opt 1 ons 



System options 

system_name = engineering_tdi_l 

data_buffer_size (before reset) » 144 

data_buffer_s1ze (after reset) = 524 

buffer .percentage = 75 

buffer _boundary_per cent ages = (40,20,5) 

memory _boundary_percent ages = (40,15,2) 

memory_manager_per1od = 20 

reserved_system_ space (before reset) = 16384 

reserved_system_space (after reset) = 16384 

standard_stack_size ■ 16384 

default_channe1_trunk - C170_trunk 

clock1ng_system = no 

maximum_recoveries ■ 5 

compress_dump = yes 



finnnniid v 
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DISPLAY_TCP_INTERFACE OPTIONS (DISTIO) 
NETOU Command 

Purpose Displays the TCP parameters defined from the DEFINE _TCP_INTERFACE 
command (described in this manual). 

Format DISPLAY_TCP_INTERFACE ..OPTIONS 

Parameters None. 

Responses The following header precedes the options display (see examples). 

TCP Interface Options 

If the TCP interface has not been defined, the following response is 
displayed within the options display. 

TCP Interface is not defined. 

Remarks See the DEFINE _TCP_INTERFACE command for a description of the 
options to be displayed. 

Examples d i sp 1 ay_t cp_ Inter f ace_opt i ons 

TCP Interface Options 
ack_per cent age = 50 
accept .strategy = in_wlndow 
max_buffers = 2048 
max_connect1ons = 200 
max_segment_size = 1510 
quiet.time = 20 

retransmit.strategy = adaptive 
retransm1t_time = 3 
security_check1ng = none 
t1me_to_11ve = 60 
syn_ack_t1me = 60 
start = true 
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DISPLAY_TCP_INTERFACE STATUS (DISTIS) 
NETOU Command 

Purpose Displays the TCP connection status. The display consists of the local and 

remote IP addresses, the TCP port, the state of the connection and the size 
in bytes, of the send and receive queue. 

Format DISPLAY_TCP_INTERFACE .STATUS 

Parameters None. 

Responses The following header precedes the status display (see examples). 

TCP Interface Connection Status 

If TCP connection is not defined, the following response replaces the status 
display. 

TCP Interface is not defined. 

If no TCP connections exist, the following response is displayed. 

TCP Interface Connection Status No Connections. 

Examples d i sp 1 ay_t cp_ 1 nt er f ace_st at us 

TCP interface Connection Status 

Local Socket Remote Socket State Send-Q Rec-Q 

192. 5. 209.1. telnet 192.5.209.53.1025 Established 1000 

192.5.209.1.ftpc 192.5.209.52.1026 Established 

192.5.209.1. telnet *.* Listen 

192.5.209.1.ftpc *.* Listen 

192.5.209.1.1027 192.5.209.52.ftpc Established 2048 



TCP Interface Connection Status Display Description 

The TCP interface connection status display includes the following 
information. 



Local Socket 



Remote Socket 



State 
Send-Q 

Rec-Q 



The IP address and port number of the Upper Layer 
Protocol (ULP) that this DI supports. 

The IP address and port number of the peer Upper 
Layer Protocol (ULP), the other end of the connection. 

The TCP state of the connection. 

The number of bytes currently in TCP send queue for 
the respective connection. 

The number of bytes currently in TCP receive queue for 
the respective connection. 
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DISPLAY_TELNET_SERVER STATUS (DISTSS) 
NETOU Command 

Purpose Displays the configuration options and status of one or more selected 
Telnet servers. 

Format DISPLAY_TELNET_SERVER _STATUS 

SERVER _NAME = list of name(s) or ALL 

Parameters SERVER JfAME (SN) 

Specifies the name(s) of the servers for which configuration options and 
status information is displayed. Default is ALL. 

Responses The following header precedes the status display (see example). 

Telnet Server Status 

If the named Telnet server is not defined, the following response replaces 
the status display. 

-WARNING-- TELNET server < server _name> was not found. 

If the keyword ALL is specified and no Telnet servers are defined, the 
following response replaces the status display. 

-WARNING- No TELNET servers were found. 

Examples distss server_name=arhnet 

Telnet Server Status 



Server ARHNET 
IP Address 
TCP Port Number 
Protocol 

Terminal Definition Procedure 
Terminal User Procedure 
Procedure File Option 
Connection Connect Timeout 
Connection Disconnect Timeout 
User Connection Limit 
Initial Option Negotiation 
Validate Users 
TCP Timeout 
Active Connections 
Server Status 



129.179.52.50 

23 

TELNET 

NONE 

NONE 

NONE 

120 

120 

4 

(WILL.SGA, WILL.ECHO) 

TRUE 

300 

12 

ACTIVE 
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DISPLAY_TELNET_SERVICE _NAME (DISTSN) j 

NETOU Command I 

Purpose Displays the name of the Telnet service used when accessing Telnet from | 

this DI. This service is accessed when a NOS/VE host application issues a | 

VTP Create CDCNET Connect request to a Telnet service. This is done, 1 

for example, when a terminal user executes the CREATE _TELNET_ | 
CONNECTION (TELNET) command on a NOS/VE system. 



?• 



The name must be the title of a User Telnet Gateway configured in the 
network. 

Format DISPLAYJTELNET .SERVICE .NAME 

Parameters There are no parameters for this command. 

Responses The Telnet service name is: < service _name>. 

Examples di spl ay_tel net.servi ce_name 

The Telnet service name: TELNET. 
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DISPLAYJTESTJSTATUS (DISTS) 
NETOU Command 

Purpose Allows you to monitor the progress of an online diagnostics test or display 
the completion status of an onboard or online diagnostics. The command 
response indicates the current status of online diagnostics in progress or 
the completion status of the last onboard, online, or inline diagnostics that 
was executed on the specified device. Use this command to get the results 
of online, onboard, and inline diagnostics. For online diagnostics, send this 
command after you receive a response to the command that starts the 
diagnostic test. The fields in the test status display are described at the 
end of this command description. 

Format DISPLAY_TEST_STATUS 

DEVICE _NAME = name or keyword value 
STATUS _TYPE= keyword value 
DISPLAY JOPTION = keyword value 

Parameters DEVICE _NAME (DN) 

Physical name of a single hardware device or a group keyword value. 
Specify a hardware device name with a $ character, a board type, and 
board slot number. Example physical names include $MCI2, $CIM3, $LIM1, 
$LIM2_PORTl, $ESCI4, $URI3, and NETWORK_l. Specify a group with 
the appropriate group keyword value. Example group keywords include 
ALL (A), MAJOR (M), LIMS (L), PORTS (P), or SUBNET (S). Default is 
ALL. 

STATUS JTYPE (ST) 

Specifies the type of test status to be returned for the specified devices. 
The allowable keywords include the following: 



Keyword Value 



Description 



ALL (A) 
RUNNING (R) 
FAILED (F) 
EXCEPTION (E) 
Default is ALL. 



Displays the status of all tests. 

Displays the status of only the running tests. 

Displays the status of only the failed tests. 

Displays the status of only the exception tests. 



DISPLAY JOPTION (DO) 

Specifies the format and level of status of the test to be returned in the 
response. 



Keyword Value 



Description 



SUMMARY (S) 
EXPANDED (E) 
Default is SUMMARY. 



Displays a single line of information per 
device. 

Displays multiple lines of information per 
device. 
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Responses The following header precedes the test status information (see examples). 

< device > < status >< test _type > test 

When errors occur, one of the following responses appears. 

Subnet < subnet _name> has not been run. The last reset was at 
<date> <time>. 

-ERROR— Device < device _name> not installed in system. 

-ERROR- No RUNNING devices found. 

-ERROR- No FAILED devices found. 
-ERROR- No EXCEPTION devices found. 

-ERROR— Subnet < subnet _name> is unknown. 

Examples The following example shows a status display for an online test that is 
currently running. 

d1splay_test_status dev1ce_name=$lim1_port2 do=expanded 

PORT test status 

CIM slot number = 3 

LIM slot number = 1 

PORT number = 2 

RUNNING online version 0901 

Testing Internal loopback 

pass count ■ 50 total errors - 3 

The following example shows a status display for online and onboard tests 
that failed. 

d 1 sp 1 ay_ t est _st at us dev 1 ce_name= $c 1 m5 

$CIM5 FAILED on-line test. 

$CIM5 FAILED on-board test. 

display_test_status device_name=$cim5 do=expanded 

CIM test status 

CIM slot number = 5 

FAILED on-line version 10H1 01/24/85 14.43.31 

Testing CIM/SMM interface 

pass count= 5 total errors* 1 

CIM test status 

CIM slot number- 1 

FAILED on-board version 09A1 01/24/85 14.43.31 
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Displays for device-passing tests: 

dlsplay.t est .status dev1cejname=$mci 1 

MCI test status 

MCI slot number = 1 

PASSED on-board version 08H1 01/16/86 14.34.21 

display_test_status device_name=$esci3 do=summary 

$ESCI3 PASSED on.llne test. 

or 

$ESCI3 PASSED on.board test. 

dlsplay.t est .status device_name=$esc13 do=expanded 



ESC I test status 

ESCI slot number= 3 

PASSED on-Hne version 2301 01/16/87 14.34.21 

pass count = 10 

or 

ESCI test status 

ESCI slot number- 3 

PASSED on-board version 0806 01/16/87 14.34.21 

In the following two examples, multiple devices were tested with online 
and inline diagnostics. 

dlsplay.t est .status status_type=except1on do=summary 

$LIM7_P0RT2 RUNNING on-Hne test 

$ESCI4 RUNNING on-line test 

SLIM7.P0RT5 FAILED on-line test 

$MCI7 FAILED In-line test 

$NET_l RUNNING subnet connect test 

d1 splay .test.status dn=major st-exceptlon do=summary 

$ESCI4 RUNNING on-line test. 

$MCI7 FAILED In-line test 
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In this example, a CIM online test passed on 01/16/85, a LIM online test 
failed on 03/18/85, a PORT online test failed 04/28/85, and a URI online 
test failed on 04/29/85. This example illustrates the use of a 
URI/LIM/PORT failure summary on the CIM test's PASSED response to 
indicate the actual status of the CIM and its URIs, LIMs and PORTs. 

d1splay_test_status device_name=$cim1 do»summary 

$CIM1 PASSED on-line test. Llm/Port errors detected. 

dlsplay.t est .status device_name=$dm1 do=expanded 

CIM test status 

CIM slot number - 1 

PASSED on-Hne version 10H1 01/16/85 14.34.21 

pass count - 10 

LIM/PORT failure summary: 

FAILED lim 4 on-line version 10H1 03/18/85 04.18.01 

FAILED 11m 5 port 1 on-line version 10H1 04/28/85 10.21.12 
FAILED uri 6 on-line version 2301 04/29/85 07.55.20 

In this example, a LIM onboard test passed on 01/16/85, and a PORT 
online test failed on 01/24/85 and 01/25/85. This example illustrates the use 
of a PORT failure summary on the LIM test's PASSED response to indicate 
the actual status of the LIM and its PORTS. 

display_test_status device_name=$lim3 do=summary 

$LIM1 PASSED on-board test. Port errors detected. 

dlsplay.test.status device_name=$11m3 do=expanded 

LIM test status 

CIM slot number = 6 

LIM slot number ■ 3 

PASSED on-board version 10H1 01/16/85 14.34.21 
PORT failure summary: 

FAILED port 1 on-line version 10H1 01/24/85 14.34.21 
FAILED port 3 on-line version 10H1 01/25/85 10.21.12 
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In this example, an onboard diagnostic issued a PASSED response following 
a nonfatal error. The ESCI transceiver has failed during onboard execution. 
This is a nonfatal error. 

dlsplay.t est .status device_name=$esc13 do=summary 

$ESCI3 PASSED on_board test. Transceiver errors detected. 

dlsplayjtest ..status device_name=$esc13 do-expanded 

ESCI test status 

ESCI slot number* 3 

PASSED on-board version 0806 01/16/87 14.34.21 

Transceiver errors detected. 

In this example, the last inline diagnostic on this device PASSED. 

disp1ay_test_status device_name-$mci1 do=expanded 

MCI test status 

MCI slot number= 1 

PASSED in-line version 2601 04/16/86 14.34.21 

In this example, the last inline diagnostic on this device FAILED. 

di splay _t est .status device_name=$mc13 do=summary 

$MCI3 FAILED in.line test. 

dlsplay.t est .status devlce_name=$mc13 do=expanded 

MCI test status 

MCI slot number* 3 

FAILED in-Une version 2601 04/16/85 14.53.31 

pass count* 1 total errors* 8 
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In the following two examples, the inline subnet test PASSED, 
d 1 sp 1 ay_t est _st at us dev 1 ce_name=$net _ 1 do=summar y 
$NET_1 PASSED subnet connect test 
display.t est .status devlce_name=$net_1 do=expanded 

$NET_l PASSED subnet connect test 

Network type = Ethernet 

Network device ■ $ESCI5 

Test Date/Time = 03/01/89 15:22:17 

Destination = TDI.C2 

Message Length = MIXED 

Message Count = 20 

Message Interval (msec.)= 200 

repeat Pass - 2 

Total Messages sent = 40 

Total Bytes sent = 18921 

Total Messages Rcvd = 40 

Total Bytes Rcvd - 18921 

Pass count = 2 

In the following two examples, the command entry and subnet test 
FAILED. 

display_t est .status device_name=$net_2 do-sunmary 

$NET_1 FAILED subnet connect test 

display_test_status device_name=$net_2 do=expanded 

$NET_1 FAILED subnet connect test 

Network type = Ethernet 

Network device = $ESCI5 

Test Date/Time = 02/22/89 09:12:37 

Destination = TDI.C2 

Message Length - MIXED 

Message Count = 20 

Message Interval (msec.)= 

repeat Pass * 

Total Messages sent - 20 

Total Bytes sent ■ 9342 

Total Messages Rcvd = 12 

Total Bytes Rcvd « 4921 

Pass count ■ 1 

Total Errors ■ 1 

Buffer Length =217 

Data checksum error in a returned message 
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Diagnostic Test Status Display Description 

The diagnostic test status display provides either a summary or expanded level of 
information about the status of device diagnostics. The summary level provides a single 
display line reporting the status of the diagnostics on each device or subnet. The 
expanded level provides multiple display lines reporting the status of the diagnostics on 
each device or subnet, as well as other information. 

The summary test status display includes the following information (as appropriate for 
the device being tested). 

Device name 

Physical name of the tested device 

Status of last test on device, including the following: 

Test status (RUNNING, PASSED, FAILED or blank). The field is blank no test 
has run on the device since the DI was last reset. 

Test type (on-board, online, or inline). 

* An indication that a subassembly has errors or that nonfatal errors exist. 

The summary display for a subnet includes the following information: 

Physical name of the subnet (Subnet _name) 

Test status (RUNNING, PASSED, or FAILED) 

Date/time stamp of the last test activity. If a test has not been run on this subnet, 
the summary line shows the date and time of the last reset. 

The expanded test status display includes the following information (as appropriate for 
the device being tested). 

Slot numbers for the device: 

Slot number for large board devices (such as CIM and ESCI). 

For LIM or URI devices, the CIM slot number as well as the LIM or URI slot 
number. 

For PORT devices, the CIM and LIM slot numbers as well as the PORT 
number. 

Status of last test on device, including the following: 

Test status (RUNNING, PASSED, FAILED, or NO TEST HAS RUN ON 
DEVICE <device_name> SINCE DI WAS LAST RESET). 

Test type (on-board, online, or inline). 

Version number of test. 

For completed tests that PASSED: 

Date and time of test. 

Pass count (only for online tests). 
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For online diagnostics tests: 
Pass count. 

A summary of the failed tests on device subassemblies, such as the status of failed 
URI, LIM, or port tests for CIM tests. If no subassembly tests have failed, MO ERRORS 
FOUND is reported for the summary. 

For completed tests that FAILED: 

Date and time of test. 
For online diagnostics tests: 

Failed operation (the area in which test failed). 

Pass count. 

Total errors. 

For devices for which no test has run since the last DI reset (device is not tested 
by onboard diagnostics): 

Date and time of last DI reset. 

For inline diagnostics tests: 

Error code of last failure. 

Total errors. 

A summary of the failed tests on subassemblies to a board, such as the status of failed 
LIM, URI or port tests for CIM tests. If no tests on subassemblies have failed, the 
message NO ERRORS FOUND is reported for the summary. 

For RUNNING online tests: 

Current operation (the area that is being tested). 

Pass count. 

Total errors. 
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The expanded display for a subnet includes the summary line containing the subnet 
name, status and date/time stamp, as well as the following information: 

Network type and the physical network device name 

Parameters from the command input: 

Destination system. 

Message length. 

Message count. 

Message interval. 

Repeat pass count. 
Total number of actual messages sent/received. 
Total number of actual bytes sent/received. 
Actual number of passes completed. 
For a test that has FAILED, the following additional information is displayed: 

Total error count. 

Buffer length of the failed message. 

An additional error message indicating the cause of the failure. 
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DISPLAYJTRACE PROCESS (DISTP) 
NETOU Command 

Purpose Displays trace information collected for the given process. Prior to 

execution of this command, the trace must be started for the specified 
process. For more information regarding the initiation of a trace process, 
see the START JTRACE .PROCESS command. 

Format DISPLAYJTRACE .PROCESS 

PROCESS = name 

DISPLAY_BIZE - integer 1 .. 65535 
FIXED _DISPLAY_OPTION = keyword value 
VARIABLE __DISPLAY_OPTION = keyword value 

Parameters PROCESS (P) 

Specifies the name of the process to be displayed. For names of processes 
that can be currently traced, see the START_TRACE .PROCESS command. 

DISPLAY _SIZE (DS) 

Specifies the number of trace entries to be displayed. See examples for 
further detail. The default is 5. 

FIXED ^DISPLAY JOPTION (FDO) 

Specifies how the fixed trace information is to be displayed. The default is 
PROCESS .SPECIFIC. The allowed keyword values are: 

HEXDATA (H) 

Displays the fixed display information as a contiguous line of 
hexadecimal numbers. 

DISPLAY.MEMORY (DM) 

Displays the fixed display information as hexadecimal numbers with 16 
bytes per line, a space separating every 2 bytes, and the character 
representation displayed at the right. 

PROCESS .SPECIFIC (PS) 

Displays the fixed display information with the received data being 
interpreted.???? 

VARIABLE _J)ISPLAY_OPTION (VDO) 

Specifies how the variable trace information is to be displayed. The default 
is PROCESS .SPECIFIC. The allowed keyword values are: 

HEXDATA (H) 

Displays the variable display information as a contiguous line of 
hexadecimal numbers. 

DISPLAY .MEMORY (DM) 

Displays the variable display information as hexadecimal numbers with 
16 bytes per line, a space separating 2 bytes, and the character 
representation displayed at the right. 
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PROCESS_SPECIFIC (PS) 

Displays the variable display information with the received data being 
interpreted. 

Responses Specific displays vary according to the process specified (see the examples). 

-ERROR- TRACE entry point not found for process < process >. 

The event codes in the displays have the following meanings. 

All Event Processes: 

Code Meaning 

Unused/uninitialized 

1 Protocol Data Unit (PDU) transmitted to lower layer 

2 PDU received from lower layer 

3 Timer expired 

4 Workcode received 

5 Link up status received from 3A 

6 Link down status received from 3A 

7 Buffer state congested 

8 Buffer state uncongested 

DFA Processes: 

Code Meaning 

20 Bad file control block received (for example, could occur if a 

timeout occurs before Transport Indication) 

Directory Processes: 

Code Meaning 

20 Data store entry added to hash bucket 

21 Data store entry added to timer chain 

22 Data store entry deleted from hash bucket 

23 Data store entry deleted from timer chain 

24 Broadcast version 3 PDU transmitted 

ES-IS Routing Processes: 

Code Meaning 

20 Extension PDU received 

21 Extension PDU transmitted 

22 Query request sent 

23 Query response transmitted 

24 ES-only notification 

25 Initialization of IS-IS complete 
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HDLC Processes: 
Code Meaning 



20 PDU in extended mode received from lower layer 

21 PDU to be discarded 

22 PDU released due to not sequenced correctly 

23 PDU released due to bad next sequence number 

24 PDU released due to action = discard input 

25 PDU released due to either (1) frame aborted, (2) ere error, (3) 
buffer underrun 

26 PDU released due to header length too small 

27 PDU released due to extended header length too small 

28 Mode change: was normal mode, now in extended mode 

RIP Processes: 

Code Meaning 



20 Update an existing IPSR network 

21 Add a new network entry to the IPSR routing tables 

22 Delete an existing IPSR network entry 

23 Delete an ARP- owned entry and create a RIP- owned entry 

24 RIP entry added due to ADD_RIP_SERVICE command processor 

25 RIP entry deleted due to one of the following causes: the 
DELETE _RIP_SERVICE command processor, UDP closes its 
RIP SAP, or the IP net for which RIP service is configured is 
cancelled. 

Transport Processes: 

Code Meaning 



20 Transmit a CLNS NSDU (Network Service Data Unit) 

21 Receive a CLNS NSDU 

22 Transmit a CONS NSDU 

23 Receive a CONS NSDU 



Examples display_trace_process system 

TRACE display at 07:44:12.938 for process SYSTEM, 45 events traced. 

Entry 41, event code 0, occurred 13200 milliseconds ago 

Fixed info - 

TCB Address - 106804 SYSTEM.AUDITS 

Status Register°00l1 Time Slices=0 ITMs Queued=0 

Variable info = 

TRACEBACK FROM 105785E IL_CHECKSUM_PMM+ 16 

CALLED FROM 100FOB4 0LL_PROGRAM_INTERFACE_PR0CS* 1A6 

CALLED FROM 1015COE SYSTEM.AUDITS* 85C 

CALLED FROM 1015780 SYSTEM.AUDITS* 3CE 

CALLED FROM 1010BD6 0LL_PROSRAM_INTERFACE_PR0CS* 17C8 

Entry 42, event code 0, occurred 13100 milliseconds ago 

Fixed info ■ 

TCB Address • 106804 SYSTEM.AUDITS 

Status Register=D008 Time Sl1ces=0 ITMs Queued=0 

Variable info ■ 

TRACEBACK FROM 1057860 IL.CHECKSUM.PMM* 18 

CALLED FROM 100FOB4 0LL_PR06RAM_INTERFACE_PR0CS» 1A6 

CALLED FROM 1015C0E SYSTEM.AUDITS* 85C 

CALLED FROM 1015780 SYSTEM.AUDITS* 3CE 

CALLED FROM 10106D6 OLL_PROGRAM_INTERFACE_PR0CS» 17C8 

Entry 43, event code 0, occurred 13000 milliseconds ago 
Fixed Info » 



8-110.4 CDCNET Commands 60000414 P 



DISPLAYJTRACE .PROCESS (DISTP) 



TCB Address « 106804 SYSTEM.AUDITS 

Status Register=2004 Time Slices=0 ITMs Oueued-0 
Variable info = 

TRACEBACK FROM 100816A EXEC.PMM* 164 

CALLED FROM 1015CB8 SYSTEM.AUDITS* 906 

CALLED FROM 1015780 SYSTEM.AUDITS* 3CE 

CALLED FROM 10106D6 OLL.PROGRAM.INTERFACE.PRCCS* 17C8 

Entry 44, event code 0, occurred 12900 milliseconds ago 

Fixed info = 

TCB Address - 106804 SYSTEM.AUDITS 

Status Register=0000 Time Siices=0 ITMs Queued=0 
Variable info • 

TRACEBACK FROM 1057860 IL.CHECKSUM.PMM* 18 

CALLED FROM 100F0B4 0LL.PR06RAM.INTERFACE PROCS* 1A6 

CALLED FROM 1015C0E SYSTEM.AUDITS* 85C 

CALLED FROM 1015780 SYSTEM.AUDITS* 3CE 

CALLED FROM 10106D6 OLL.PR0GRAM.INTERFACE.PR0CS* 17C8 

Entry 45, event code 0, occurred 5200 milliseconds ago 

Fixed info * 

TCB Address = 1C4868 LOCAL.CONSOLE.FORMATTER 

Status Register=0009 Time Slices=0 ITMs Queued=0 

Variable info - 

TRACEBACK FROM 100A310 CYBIL_RUN_TIME_R0UT1NES*PMM* 76E 
CALLED FROM 1B1266 CDCNET_DI_MESSAGE_FORMATTER* 1FB2 
CALLED FROM 1B08A4 CDCNET_DI_MESSAGE_FORMATTER* 15F0 

CALLED FROM 1AE812 LOCAL.CONSOLE* .FORMATTER* 118 
CALLED FROM 10106D6 OLL_PROGRAMJNTERFACE_PROCS* 17C8 

display_trace_process process=dod_ internet . . 
display_size=3 f 1xed_data_option=hexdata .. 
variable_d1splay_option=process_specif ic 

TRACE display at 15:07:14.226 for process DOtLINTERNET, 95 events traced. 

Entry 93, event code 2, occurred 19500 milliseconds ago 

Fixed info « 0800253006B90800253006B8080014140300080005010001001CC3C0001DBC3C 
Variable info « 

IP header = 45000029003100003906FEBF81B33FCF81B33FA9 

Source = 129.179.63.207, Destination = 129.179.63.169 

ID = 0031(16), Time-to-live « 57, Protocol • 6, PDU length = 41 

IP User Data » 

0472 0017 0271 0A32 0196 28F9 5018 1000 r q 2 ( P 
10 C0E2 004F 2036 3630 0025 O 660 X 

Entry 94, event code l, occurred 19500 milliseconds ago 

Fixed info • 001A442201910800253006B83B2481B33FCF6B7E0293000161636B7E00271EB2 

Variable Info - 

IP header = 45000029002B00003B06FCC581B33FA981B33FCF 

Source = 129.179.63.169, Destination » 129.179.63.207 

ID = 002BO8), Time-to-live ■ 59, Protocol « 6, PDU length = 41 

IP User Data ■ 

0017 0472 0196 28F9 0271 0A33 5018 1000 r < 3PP 
10 C104 002C 20 

Entry 95, event code 2, occurred 1940O milliseconds ago 

Fixed info ' 0800253006B90800253006B80800FEFE0300080005010001001CC3C000143FCC 
Variable Info - 

IP header ■ 45000028003200003906FEBF81B33FCF81B33FA9 

Source • 129.179.63.207, Destination • 129.179.63.169 

ID = 0032(16), Time- to- live ■ 57, Protocol • 6, PDU length <= 40 

IP User Data * 

0472 0017 0271 0A33 0196 28FA 5010 1000 r q 3 ( P 
10 0304 DE34 3630 3630 0025 46060 X 

(j<sp!ay_trace_process process=X25j>L . . 
display_size=3 f ixed_data_option=displayjnemory .. 
var i ab 1 e.d i sp 1 ay .opt i on«di sp 1 ay .memory 

TRACE display at 14:46:03.190 for process X25.PL , 24013 events traced. 

Entry 9 , event code l, occurred 24900 milliseconds ago 
Fixed info « 

0022 B516 0021 DD1C 3120 2020 2020 2020 " ! 1 

10 2020 2020 2020 2012 0016 0016 0004 0000 

20 0000 0000 0000 0000 0000 0000 0005 0001 

30 0000 0002 0001 0002 
Variable info * 

1016 2814 1400 0304 0000 0AA1 0000 0104 ( 

10 0800 2510 0072 0000 0091 0900 25FF FFFF % r X 

20 0000 1056 0800 2510 0072 0000 0091 0900 V X r 
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30 25FF FFFF 0000 2749 0800 2510 0072 OBFA X 'I X r 

40 0011 0900 25FF FFFF 0000 3191 0800 2510 X 1 X 

50 0072 OOOA 0011 0900 25FF FFFF r X 

Entry 10 , event code l, occurred 23800 milliseconds ago 
Fixed info ■ 

0022 B516 0021 DD1C 3120 2020 2020 2020 " ! 1 

10 2020 2020 2020 203E 0016 0016 0004 0000 > 

20 0000 0000 0000 0000 0000 0000 0006 0001 

30 0000 0002 0001 0002 

Variable info ■ 

1016 2A14 1400 0304 0000 7B86 0000 0104 

10 0800 2530 00C1 0000 0091 0900 25FF FFFF 

20 0000 1056 0800 2530 00C1 0000 0091 0900 

30 25FF FFFF 0000 2749 0800 2530 00C1 OBFA 

40 0011 0900 25FF FFFF 0000 3191 0800 2530 X 1 XO 

50 0OC1 OOOA 0011 0900 25FF FFFF X 



» 




{ 


XO 




X 


V 


XO 

'1 


XO 


X 




1 
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Entry 11 , event code 2, occurred 23800 milliseconds ago 
Fixed info = 

0022 B516 0021 DD1C 3120 2020 2020 2020 " ! 1 

10 2020 2020 2020 2046 0016 0016 0004 0000 F 

20 0000 0000 0000 0000 0000 0000 0006 0001 

30 0000 0002 0001 0002 
Variable info = 

1016 A214 1400 0304 0000 7B86 0000 0104 { 

10 0800 2530 00C1 0000 0091 0900 25FF FFFF X0 X 

20 0000 1056 0800 2530 00C1 0000 0091 0900 V X0 

30 25FF FFFF 0000 2749 0800 2530 00C1 06FA X '1 X0 

40 0011 0900 25FF FFFF 0000 3191 0800 2530 X 1 XO 

50 00C1 OOOA 0011 0900 25FF FFFF X 

Entry 12 , event code 1, occurred 600 milliseconds ago 
Fixed info ■ 

0022 B516 0021 DD1C 3120 2020 2020 2020 " ! 1 

10 2020 2020 2020 2082 0016 0016 0004 0000 

20 0000 0000 0000 0000 0000 0000 0007 0002 

30 0001 0005 0002 0005 

Variable info = 

1016 4CFE FE0O 821E 0100 0400 7DO0 0014 L } 

10 3984 0FO1 BB7B 0000 0000 0031 9108 0025 9 { IX 

20 1000 7200 r 

Entry 13 , event code 1, occurred 600 milliseconds ago 
Fixed info • 

0022 B516 0021 DD1C 3120 2020 2020 2020 " ! 1 

10 2020 2020 2020 2096 0016 0016 0004 0000 

20 0000 0000 0000 0000 0000 0000 0000 0002 

30 0001 0005 0002 0005 

Variable info = 

1016 4E18 1800 0000 2401 8000 0000 007D N $ } 

10 0000 0559 0000 0014 0004 2749 06FA 3191 Y '11 

20 OOOA 0104 0000 1056 0000 V 

The following are outputs shown in the three different formats for FIXED_ 
DISPLAY_OPTION: 

dlsplay_trace_process process=channel .connect ion .. 
dispiay_slze=l f lxed_display_option=process_specif ic 

TRACE display at 13:43:22.626 for process CHANNEL.C0NNECTI0N, 73 events traced. 

Entry 73 . event code 2 , occurred 8766900 milliseconds ago 
Fixed info = 

Channel connection cepid = 001CEEF2 

Actual user data size * 

Channel Connection PDU header = 0500000000000010000106412E485001 

LIB " 00107E22 
Variable info ■ NONE 

display_trace_process process=channel_connection .. 
d1sp1ay_size=l f 1xed_d1splay_option=displayjnemory 

TRACE display at 13:44:03.641 for process CHANNEL.CONNECTION , 73 events traced. 

Entry 73 . event code 2 , occurred 8807900 milliseconds ago 
Fixed info = 

001C EEF2 0000 0500 0000 0000 0010 0001 
10 0641 2E48 5001 0010 7E22 A.HP "" 

Variable info - NONE 

display.trace.process process«channel .connection .. 
d1splay_size*1 f ixed_d1sp1ay_option=hexdata I 

TRACE display at 13:43:52.306 for process CHANNEL.CONNECTION , 73 events traced. | 

Entry 73 , event code 2 . occurred 8796600 milliseconds ago | 

Fixed info = 001CEEF200000500000000000010000106412E48500100107E22 1 

Variable mfo = NONE % 
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DISPLAYJTRUNK .METRICS (DISTM) 
NETOU Command 

Purpose Displays the statistics collected for one or more communications trunks. 
The Stream Service Routines (SSRs) supporting the trunks collect the 
statistics. 

Statistics collection for the specified trunks must have been started before 
executing this command. Use the STARTJTRUNK .METRICS command, 
described in this manual, to begin statistics collection by the supporting 
SSR. 

The collected statistics information clears each time trunk metrics for the 
specified trunks are reported on the network logs. Thus, the displayed 
statistics are the accumulation of statistics information since the last 
reporting of trunk metrics. Specify the reporting interval with a parameter 
on the START_TRUNK .METRICS command. See the STARTJTRUNK _ 
METRICS command for more information regarding the reporting of trunk 
metrics. 

Format DISPLAYJTRUNK .METRICS 

TRUNK _NAME = list 1..15 of name or ALL 

Parameters TRUNK _NAME (TN) 

Specifies the trunk or trunks for which the statistics are to be displayed. 
Default is ALL. 

Responses Displays vary according to the type of trunks specified (see examples). 

One of the following responses displays if the specified metrics are not 
reported. 

Trunk <name> is not defined, or is defined but not started. 
SUMMARY metrics have not been started for TRUNK <name>. 
Examples This example shows the display for a CHANNEL trunk. 
display_trunk_metrics md_trunk 
Summary Trunk Metrics 
CHANNEL Trunk = MCI.TRUNK 
Start Of collection = 14:44:13 

Messages transmitted - 151 
Characters transmitted = 13483 
Transmit rate (bps) - 248 



Elapsed time 


= 00:07:08 


Messages received 


= 236 


Characters received 


= 16474 


Receive rate (bps) 


- 304 
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Message Size Distribution 
size <256 <512 <768 
xmt 145 2 4 

rev 236 

Messages retransmitted ■ 
Length errors = 
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<1024 







<1260 







<1536 







<1792 




Messages discarded 
Bus errors 



This example shows a display for an ETHER trunk. 
display_trunk_metrics $esc15 
Summary Trunk Metrics 



1792+ 












ETHER Trunk - $ESCI5 
Start of collection 



14:45:58 
157 



Messages transmitted 
Characters transmitted = 10941 
Transmit rate (bps) - 264 

Message Size Distribution 
size <256 <512 <768 
xmt 157 
rev 133 1 2 

Message Transmission Errors 

too many collisions = 

lost carrier sense = 

lost CTS signal = 

memory underrun = 

rejected by DVM = 

pack message failed = 

total collisions ■ 



Elapsed time 


= 00:05:23 


Messages received 


= 136 


Characters received 


= 11616 


Receive rate (bps) 


= 280 


<1024 <1280 <1536 















Message Reception Errors 

CRC errors * 

alignment errors - 

no resources « 

memory overrun » 

minimum size error = 

exceed max length * 

incorrect status = 

Incorrect length = 
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This shows the display for all the trunks on a system. Note that metrics 
had not been previously started for the ETHER trunk, but had been 
started for the HDLC and X.25 trunks. 

d 1 sp 1 ay_t r unkjnet r 1 cs 
Summary Trunk Metrics 



SUMMARY metrics have not been started for TRUNK $ESCI5. 

HDLC Trunk = HDLC.TRUNK 

Start of collection = 14:48:34 Elapsed time 



I frames transmitted = 60 
S frames transmitted = 22 
U frames transmitted = 
Characters transmitted = 3234 
Transmit rate (bps) = 136 

Message Size Distribution 
size <256 <512 <768 
xmt 60 
rev 22 



I frames received 
S frames received 
U frames received 
Characters received 
Receive rate (bps) 



<1024 







<1280 







<1536 







= 00:03:06 

= 22 
= 57 
= 
= 1244 

= 48 



Bad frames recleved •= 
Frames retransmitted = 
CRC Errors * 



Frames out of sequence • 
Frames discarded = o 



X.25 Trunk = REM0TE_TRUNK 

Start of collection = 14:48:45 

I frames transmitted = 53 
S frames transmitted ■ 49 
U frames transmitted = 
Characters transmitted ■ 3070 
Transmit rate (bps) = 136 



Message Size Distribution 

Size <256 <512 <768 

xmt 53 

rev 49 

Bad frames recleved ■ 

Frames retransmitted = 

CRC Errors = 



: Elapsed time 


- 00:02:55 


I frames received 


= 49 


S frames received 


= 40 


U frames received 


= 


Characters received 


■ 2151 


Receive rate (bps) 


= 96 


<1024 <1280 <1536 














Frames out of sequence 


= 


Frames discarded 


- 
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DISPLAY_USER_VALIDATION (DISUV) 
NETOU Command 

Purpose Displays if validation is defined, the default validation domain, and the 

number of unsuccessful login attempts allowed. 

Format DISPLAY_USER .VALIDATION 

Parameters None. 

Responses User validation is not defined. 

User validation is defined. 

default _validation_domain = < validation domain > 

maximum _login_attempts = < attempts > 

Examples display_user_val Idation 

User validation 1s defined, 
default .validation. domain = ARH 
max1mum_login_attempts = 3 
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DISPLAY_X25_ASYNCTIP OPTIONS (DISXAO) 
NETOU Command 

Purpose Displays the configuration of an X.25 asynchronous TIP for each X.25 
trunk supported by the TIP. The display returns the set of default TIP 
parameters and terminal usage parameters that apply to each X.25 trunk. 

Format DISPLAY.X25 _ASYNCTIP_OPTIONS 

TRUNK _NAME = list 1..32 of name 
DISPLAY JOPTION = list of keyword values 

Parameters TRUNK JNAME (TN) 

Specifies the name(s) of the one or more X.25 trunks for which X.25 
asynchronous TIP support is defined. If TRUNK _NAME is not specified, 
the display presents the X.25 asynchronous TIP definition for each X.25 
trunk supported by the TIP. 

DISPLAY JOPTION (DO) 

Specifies the name(s) of one or more X.25 asynchronous TIP attributes for 
display. These attributes are defined by parameters on the DEFXA 
command that configured the line. For more information on these 
parameters, see the DEFXA command description in this manual. The 
allowed keyword values are: 

TRUNK _NAME (TN) 

TERMINAL .DEFINITION .PROCEDURE (TDP) 
TERMINAL _USER .PROCEDURE (TUP) 
PROCEDURE _FILE .OPTION (PFO) 
LOGICAL .CHANNEL .CONCATENATION (LCC) 
CALLED _DTE .CONCATENATION (CDC) 
CALL .DATA .PROCEDURE (CDP) 
CALLED _DTE .ADDRESS .RANGE (CDAR) 
CONNECTION .CONNECT.TIMEOUT (CCT) 
CONNECTION .DISCONNECT.TIMEOUT (CDT) 
USER.CONNECTION .LIMIT (UCL) 
ACCEPT.REVERSE .CHARGES (ARC) 
PERMANENT.VIRTUAL .CIRCUITS (PVC) 
PVC .CHANNEL .CONCATENATION (PCC) 
PVC.PACKET.SIZE (PPS) 
PVC.WINDOW.SIZE (PWS) 
VALIDATE .USERS (VU) 
ALL (A) 

Default is ALL. 
Responses The following header precedes the options display (see examples). 

X.25 Asynctip options 
Within the options display, the following response is inserted if 
support is not defined for a TRUNK .NAME. 

X.25 AsyncTip support not defined for trunk <name>. 

Within the options display, the following response is inserted if no X.25 
asynchronous TIP support is defined in the system. 
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No X.25 AsyncTip support is defined for this system. 
Examples d 1 sp 1 ay _x25_asynct 1 p.opt 1 ons 

X.25 Asynctlp options 

trunk.name = TELENET_1 

term1nal_def1Mt1on_procedure = none 

terminal .user .procedure = TELENET.721 

procedure.fi le.opt Ion = LOGICAL_CHANNEL_CONCATENATION 

called_dte_address_range = 1..15 

connect ion_connect .timeout =120 

connect ion.dlsconnect .timeout = 120 

user_connect1on_Hm1t = 4 

accept .reverse.charges = no 

permanent.vlrtual.drcults * 1..15 

pvc.channel .concatenation = no 

pvc.packet.s1ze = 256 

pvc.wlndow.s1ze = 3 

trunk.name - TELENET.2 
term1nal_def1n1tion_procedure = none 
term1nal_user_procedure ■ TELENET. VT100 
procedure.fi le.opt Ion ■ none 
cal led_dte_address_range = 1 . . 15 
connect ion.connect.tlmeout = 50 
connect Ion.dlsconnect.tlmeout = 20 
user.connectlon.llmlt ■ 4 
accept.reverse.charges = yes 
permanent.vlrtual.drcults ■ 
pvc.channel .concatenation = no 
pvc.packet.s1ze = 
pvc_w1ndow_s1ze = 
valldate.users = yes 
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DISPLAY_X25_GW_INCALL OPTIONS (DISXGIO) 
NETOU Command 

Purpose Displays the incall validations to be performed by an X.25 

application-to-application (A-to-A) gateway. The display includes the DTE 
addresses, service titles, and reverse charging option accepted by the 
gateway. 

Format DISPLAY_X25 _GW_INCALL OPTIONS 

GATEWAY _NAME=list 1..15 of name or ALL 

Parameters GATEWAY 'JNAME (GN) 

Specifies the names of the X.25 gateways which receive incoming X.25 
A-to-A calls. Default is ALL. 

Responses -ERROR- An X.25 gateway is not defined. 

-ERROR- X.25 gateway <name> is not defined. 

Examples display_x25_gw_lncal l_options gateway.name ■ X25GW 

X.25 Gateway incall configuration 
gateway_name: X25GW 



remote dte 
addresses : 

408123 

408456 

612789 

OTHER 



allowed_titles: 



PTFS$* 
QTFS$* 
PTFS$« 
QTFS$* 
PTFS$* 
QTFS$* 
ALL 



accept 

reverse 

charging: 

YES 

YES 

YES 

YES 

YES 

YES 

NO 
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DISPLAY_X25_GW_OPTIONS (DISXGO) 
NETOU Command 

Purpose Displays the configuration of an X.25 transparent gateway. The display 

returns CDCNET title(s) by which the gateway is known in the CDCNET 
network and the protocol identifiers (prid) used by the gateway to 
distinguish incoming connections to NOS or NOS/VE hosts. 

Format DISPLAY_X25_GW_OPTIONS 

GATEWAY _NAME= list 1..15 of name or ALL 
DISPLAY JOPTION = list of keyword values 

Parameters GATEWAY \JfAME (GN) 

Specifies the name(s) of the X.25 gateways which receive incoming X.25 
application-to-application calls. Default is ALL. 

DISPLAY JOPTION (DO) 

Specifies one or more of the gateway attributes for display. The keyword 
values include the following items. 

GATEWAY_NAME (GN) 

TRUNK _NAME (TN) 

NOS_PROTOCOL_ID (NPI) 

CDCNET_PROTOCOL_ID (CPI) or VE_PROTOCOL_ID (VPD 

NOS_PORT_NUMBER (NPN) 

VE_OUTCALL_TITLE (VOT) 

DTE_ADDRESSING_PROTOCOL (DAP) 

ALL (A) 

Default is ALL. 
Responses —ERROR- An X.25 gateway is not defined. 

—ERROR- X.25 gateway <name> is not defined. 
Examples d i sp 1 ay_x25_gw_opt i ons 

x.25 Gateway options 
gateway.name ■ TELENET_GW 
trunk.name = (TELENET_1,TELENET_2) 
nos_protocol_td = (0C0(16).0C1(16)) 
cdcnet_protocol_ld ■» 0C2(16) 
dte_addressing_protocol_ld ■ 002(16) 
nos_port .number - (023(16). 024(16)) 
ve_outcaii_titie = telenet_GW 
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DISPLAY_X25 _GWJ3UTC ALL ..OPTIONS (DISXGOO) 
NETOU Command 

Purpose Displays the outcall titles of an X.25 transparent gateway. 

Format DISPLAY.X25 _GW_OUTCALL .OPTIONS 

GATEWAY _&AME = list 1..15 of name or ALT. 

Parameters GATEWAY _NAME (GN) 

Specifies the names of the X.25 gateways to display that provide access to 
remote applications. Default is ALL. 

Responses The following header precedes the X.25 gateway _name display (see 
examples). 

X.25 Gateway outcall configuration. 

One of the following responses appears when errors occur. 

-ERROR- X.25 gateway <name> is not defined. 

-ERROR- An X.25 gateway is not defined. 

Examples display_x25_gw_outcal l_options 

gateway.name = Telenet 
title = PTFS$FOREIGN 
remote_dte_address ■ 3401 
facilities = NONE 
protocol _ld = c2 
user_data = NONE 
local_dte_address = NONE 
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DISPLAY_X25 _GW_PVC .OPTIONS (DISXGPO) 
NETOU Command 

Purpose Displays the PVC and other pertinent information associated with the 

given X.25 gateway. 

Format DISPLAY_X25 _GW_PVC .OPTIONS 

GATEWAY _NAME = list 1..15 of name or ALL 

Parameters GATEWAY_NAME (GN) 

Specifies the names of the X.25 gateways for which PVC information is 
being requested. Default is ALL. 

Responses The following header precedes the X.25 gateway _name display (see 
examples). 

X.25 Gateway PVC configuration 

One of the following responses appears when errors occur. 

-ERROR-- X.25 gateway <name> is not defined. 

-ERROR- An X.25 gateway is not defined. 

-INFORMATIONAL- No PVCs exist for X.25 gateway <name>. 



Examples 



d 1 sp 1 ay_x25_gw_pvc_opt 1 ons 

X.25 Gateway PVC configuration 

gateway_name= Telenet 
title= PVC$FRN 
PVC =100 

pvc_packet_s1ze » 128 
pvc_window_s1ze = 2 

gateway_name= Telenet 
t1t1e= PVCSGER 
PVC =101 

pvc_packet_s1ze - 128 
pvc_w1ndow_s1ze = 2 
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DISPLAY_X25_INCALL (DISXI) 
NETOU Command] 

Purpose Displays configured X.25 incall definition entries added by using the ADD_ 
X25_INCALL command, for one or more trunk names and one or more 
remote DTE addresses. 

Format DISPLAY_X25 _INCALL 

TRUNK _NAME = list 1..32 of name 

REMOTE J>TE ^ADDRESSES = list 1..31 of string 1..31 

Parameters TRUNK JSfAME (TN) 

Specifies the set of trunks associated with the X.25 incall definition entries 
to be displayed. The value ALL is used to display the specified entries 
associated with the remote DTE addresses on all trunks previously 
configured with X.25 incall definition entries. The default is ALL. 

REMOTE JDTE _ADDRESSES (RDA) 

Specifies the set of remote DTE addresses associated with the X.25 incall 
definition entries to be displayed. Wild card attributes (as specified by 
command ADD_X25 JNCALL) must exactly match an entry as specified 
by ADD_X25_INCALL. For example, a value of '123*' will match only on 
entry '123*'. It will not match all entries with '123* as the first three 
digits. If a REMOTE _DTE .ADDRESSES value has multiple entries 
associated with it (due to different values of DTE_ ADDRESS _ 
PROTOCOLED), all of those tries will be displayed. The value OTHER 
corresponds to any entries del ;d with the value OTHER. The value ALL 
is used to display all X.25 incall definition entries for the trunks specified 
The default is ALL. 

Responses The configuration for each trunk is displayed separately. For each remote 
DTE address for which an X.25 incall definition entry is configured, the 
configurable parameters are displayed. All entries with the same parameter 
settings are grouped together. Please see the example for the format of 
this display. 

The following response is generated if no X.25 incall definition entry is 
configured, regardless of input errors: 

No X.25 incall definition entry for any trunk is defined. 

The following response is generated if X.25 incall definition entries are 
configured, but none for a trunk explicitly specified: 

No X.25 incall definition entry for trunk < trunk _name> is defined. 
Error responses: 

-ERROR-- An X.25 incall definition entry for the remote DTE address 
< remote _dte_address> is not defined for trunk < trunk _name>. 

-ERROR- Trunk name < trunk _name> is not defined. 

-ERROR- Trunk name < trunk _name> is not an X.25 trunk. 

-ERROR- Trunk name < trunk _name> may not appear more than 
once in the list of specified trunks. 
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-ERROR— Remote DTE address < remote _dte_address> may not 
appear more than once in the list of specified remote DTE addresses. 

-ERROR— The remote DTE address < remote _dte_address> contains 
invalid characters. 

-ERROR- The remote DTE address < remote _dte_address> has an 
invalid bracketed expression. 

-ERROR- No X.25 incall definition entry for any trunk is defined. 

-ERROR— No X.25 incall definition entry for trunk < trunk _name> is 
defined. 

-FATAL- Not enough memory available for required table space. 

Examples a i sp l ay _x25_ incall 

X.25 Incall Definition Entries for trunk X25.TRUNK: 

Remote DTE Addresses 123745 [5-7] 65« 

12345 
DTE Address Protocol Id 3 , 8. . 12 
Accept PDN charges TRUE 

Remote DTE Addresses 123?54[5-7}65« 

12345 
DTE Address Protocol Id 6 , 55.. 66 
Accept PDN charges FALSE 

X.25 Incall Definition Entries for trunk TRANSPAC: 

Remote DTE Addresses 123?45[5-7]65» 

12345 

345678901 
DTE Address Protocol Id 3 , 8..12 
Accept PDN charges FALSE 

display _x25_incal 1 trunk_name=ACCUNET 

No X.25 Incall definition entry for trunk ACCUNET is defined. 

disp1ay_x25_1ncall trunk_name=X25.TRUNK remote.dte.addresses- 123456 

—ERROR— An X.25 mcall definition entry for the remote DTE address 
123456 is not defined. 
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DISPLAY_X25 .INTERFACE .OPTIONS (DISXIO) 
NETOU Command 

Purpose Displays the configuration of an X.25 packet level interface. The packet 
level interface may provide interface for an X.25 gateway, X.25 AsyncTip 
or for an X.25 network solution. 

Format DISPLAY.X25 .INTERFACE .OPTIONS 

INTERFACE _NAME = list 1..15 of name 
DISPLAY JOPTION = list of keyword values 

Parameters INTERFACE _JfAME (IN) 

Specifies the logical name(s) of the packet level interface to be displayed. 
The name was previously assigned by a DEFINE command. If an 
INTERFACE _NAME is not specified, the display presents configuration 
information for all packet level interfaces defined for the system. 

DISPLAY JOPTION (DO) 

Specifies one or more of the interface attributes for display. These 
attributes are defined by parameters on the DEFXI command that 
configured the line. For more information on these parameters, see the 
DEFXI command description in this manual. The allowed keyword values 
are: 

TRUNK _NAME (TN) 
PUBLIC _DATA_NETWORK (PDN) 
INTERFACE _NAME (IN) 
LOCAL _DTE .ADDRESS (LDA) 
PACKET_SEQUENCE .NUMBERING (PSN) 
PVC .RANGE (PR) 
INONLY.RANGE (IR) 
TWOWAY.RANGE (TR) 
OUTONLY.RANGE (OR) 
DEFAULT_WINDOW_SIZE (DWS) 
DEFAULT_PACKET_SIZE (DPS) 
CONGESTED .THRESHOLD (CT) 
INTERFACE .STANDARD (IS) 
SUBSCRIBED .FACILITIES (SF) 
ALL (A) 

Default is ALL. 
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Responses The following header precedes the X.25 interface options display (see 
example). 

X.25 Interface Options 

Within the options display, the following response is inserted if the 
INTERFACE _NAME is not defined. 

X.25 interface <name> is not defined. 

Within the options display, the following response is inserted if no X.25 
interfaces are defined in the system. 

No X.25 interfaces are defined for this system. 

Examples d1splay_x25_interface_optlons ln=telenet_1nterface 

X.25 Interface Options 
trunk.name = TELENET, 1 
pub I1c_data_net work = TELENET 
1nterface_name - TELENET_INTERACE 
local_dte_address = '6121231234' 
packet_sequence_numbering - NORMAL 
pvc.range ■ -NONE_DEFINED 
1nonly_range = 1..24 
twoway.range = 25.. 32 
outon1y_range ■ -NONE.DEFINED 
default_w1ndow_size ■ 7 
default_packet_size = 128 
congest ed_thresho Id = 40 
1nterface_standard = CCITT_198D 
subscrlbed_fad Titles - none 
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DISPLAY_X25_INTERFACE_STATUS (DISXIS) 
NETOU Command 



Purpose 



Format 



Parameters 



Responses 



Displays the operating status of one or more X25 interfaces. The display 
includes the name and status of the X.25 interface, the name and status of 
the trunk serving the interface, trunk type, and information related to the 
service access points (SAPs) and connections serviced by the X.25 interface. 

The possible trunk types associated with an X.25 interface are: 

Trunk Type Description 



LAPB 



Non-LAPB 



The interface is communicating with a PDN 
(DTE-to-DCE or DCE-to-DTE). 

The interface is communicating with another 
DTE (DTE-to-DTE) over a non-LAPB 
connection (over HDLC). 



LLC2 



The interface is communicating with another 
DTE (DTE-to-DTE) using the LLC 2 protocol 
(over Ethernet). 

DISPLAY J£25_INTERFACE_STATUS 

INTERFACE_NAME = list 1.. 15 of name 
DISPLAY_OPTION = keyword value 

INTERFACE_NAME (IN) 

Specifies the name of the interface or interfaces for which status is to be 
displayed. Default is all interfaces. 

DISPLAY_OPTlON (DO) 

Displays the level of status response. The allowed keyword values are: 

Keyword Value Description 



SUMMARY (S) 
EXPANDED (E) 

EXTENDED (X) 



Displays general status information. 

Displays the summary information as well as 
detailed information regarding the virtual 
circuits serviced by the interface. 

Displays the same information as the 
EXPANDED keyword except that the CEPID 
column is replaced by a column entitled 
VIRTUAL CIRCUIT NAME, which lists the 
terminal names corresponding to the logical 
channel numbers. 

Default is SUMMARY. 

The following header precedes the status display (see example). 

X.25 Interface Status 
If errors occur, one of the following responses appears. 

X.25 Interface <name> is not defined. 

No X.25 interfaces are defined for this system. 
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DISPLAYJC25JNTERFACE J5TATUS (DISXIS) 



Examples 



d'i sp 1 ay_x25_ 1 nt er f ace_st at us cdcnet _ 1 ab_ 1 f 



X.25 Interface Status 

interface name « CDCNET_LAB_IF 

Interface status ■ active 

trunk name - CDCNET.LAB.TRUNK 

trunk status - active 

number of SAPs ■ 2 

number of virtual circuits = 5 

number of virtual circuits congested » 2 

trunk type ■ LAPB 

d1splay_x25_lnterface_status cdcnet_Jab_1f do-expanded 

X.25 Interface Status 

Interface name - CDCNET_LAB_IF 

Interface status ■ active 

trunk name - CDCNET.LAB.TRUNK 

trunk status ■ active 

number of SAPs * 2 

number of virtual circuits = 5 

number of virtual circuits congested = 2 

trunk type * LAPB 

SAP table address » 107B2A(16) 

protocol Ids - (0C0(16). 0CK16), 0C2(16)) 

virtual circuits 



logical 


type 


priority 


circuit 


output 


cepld 


channel 






congestion 


packets/ 




number 








bytes 




2095 


pvc 


batch 


no 


0/0 


109522(16) 


1163 


two way 


interactive 


yes 


5/620 


106666(16) 


5 


In only 


batch 


yes 


7/917 


103952(16) 


22 


out only 


batch 


no 


0/0 


102344(16) 


99 


dynamic 


batch 


no 


0/0 


108764(16) 



SAP table address = 1075ACO6) 

protocol ids - (OC0(16). 0C1(16), 0C2(16)) 

virtual circuits 



logical 
channel 
number 

2999 



type 



two way 



priority 


circuit 


output 


cepid 




congestion 


packets/ 
bytes 




interactive 


no 


0/0 


107654(16) 
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DISPLAY_X25_NET .OPTIONS (DISXNO) 
NETOU Command 

Purpose Displays the current configuration of an X.25 network. 

Format DISPLAY.X25 _NET_OPTIONS 

NETWORK_NAME = list 1..15 of name 
DISPLAY JOPTION = list 1..12 of keyword value 

Parameters NETWORK J^AME (NN) 

Displays a list of logical names, of one or more X.25 networks, that were 
assigned with a DEFINE _X25_NET command (defined earlier in this 
manual). Default displays all X.25 networks. 

DISPLAY _OPTION (DO) 

Displays one or more of the X.25 network attributes. These attributes are 
defined by parameters on the DEFXA command that configured the line. 
For more information on these parameters, see the DEFXA command 
description in this manual.The following keyword values are allowed. 

TRUNK _NAME (TN) 
REMOTE _DTE .ADDRESS (RDA) 
NETWORK _ID (NI) 
NETWORK _NAME (NN) 
COST (C) 

RELAY.ALLOWED (RA) 
ROUTING _INFO_NETWORK (RIN) 
NETWORK_PROTOCOL_ID (NPI) 
ACCEPT_PDN .CHARGES (APC) 
OUTPUT_QUEUE_LIMIT (OQL) 
INCOMING_SERVICE .ACCESS (ISA) 
OUTGOING_SERVICE .ACCESS (OSA) 
ALL (A) 

Default is ALL. 
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DISPLAYJC25 JSTET_0PT10NS (DISXNO) 

Responses The following header precedes the X.25 network options display (see 
example). 

X.25 Network options 

Within the list of options, one of the following responses is inserted if a 
network name is not defined, is not an X.25 network or if no X.25 
networks are defined, respectively. 

Network <name> is not defined. 

Network <name> is not an X.25 network. 

No X.25 networks are defined for this system. 

Examples display_x25_net_opt ions nn=x25_tymnet 

X.25 Network options 

trunk.name = TYMNET_TRUNK_LINE_1 

remote_dte_address = 6124825000 

network.id - 123456(16) 

network_name » X25_TYMNET 

cost = 200 

re lay_al lowed = no 

rout1ng_1nfo_network = yes 

network_protocol_id = C3(16) 

accept _pdn_charges = yes 

out put _queue_ limit = 30000 

1ncoming_service_access = all 

1ncoming_serv1ce_access titles = none 

outgo1ng_service_access ■ none 

outgoing_service_access titles = none 
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DISPLAY_X25 .SWITCH (DISXS) 
NETOU Command 

Purpose Displays previously configured X.25 switch definition entries for one or 
more X.25 Gateway names and one or more called DTE addresses. 

Format DISPLAY_X25 .SWITCH 

GATEWAY JVAME = list 1..32 of name or ALL 

CALLED JZTE ^ADDRESSES = list 1..31 of string 1..31 or OTHER or 
ALL 

Parameters GATEWAY _NAME (GN) 

Specifies a set of X.25 Gateways associated with the X.25 switch definition 
entries to be displayed. Use ALL to display all X.25 Gateways previously 
configured with X.25 switch definition entries. The default is ALL. 

CALLED _DTE _ADDRESSES (CDA) 

Specifies one or more called DTE addresses. To associate the switch 
definition with multiple DTE addresses, a DTE address can contain wild 
card attributes as follows: 

[D1-D2] Within a bracketed group, a range of digits can be specified. Dl 
represents the low end of the range; D2 represents the high end. 
Any value within the range can be used to match a digit in the 
position specified in the address. For example, 1234[6-7]59 
matches two DTE addresses: 1234659 and 1234759. 

[...] Within a bracketed group, any list of single digits can be 

specified. For example, 1234[179]59 matches three DTE 
addresses: 1234159, 1234759, and 1234959. 

* Any single * can be used to match a string of digits, including 

the null string. For example, 1234* matches 1234, 12341, 
1234562345, and so forth. 

7 Any single ? can be used to match a digit in the position 

specified in the address. For example, 1234759 matches 10 DTE 
addresses: 1234059, 1234159, 1234259 ... 1234959. 

If multiple ADD_X25 .SWITCH definitions exist that match a given DTE 
address, the call definition associated with the most specific string is 
displayed. For example, 123756 is more specific than 123* in matching 
called DTE address 123456. 

The value OTHER corresponds to any entries defined with the value 
OTHER. The value ALL displays all X.25 switch definition entries for the 
X.25 Gateways specified. The default is ALL. 

Responses The configuration for each X.25 Gateway is displayed separately. For each 
called DTE address for which an X.25 switch is defined, the configurable 
parameters are displayed. All entries with the same parameter settings are 
grouped. For the format of this display, see the example. 

The following response is generated if no X.25 switch is defined, regardless 
of input errors: 
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DISPLAY_X25J3WITCH (DISXS) 



No X.25 switch definition entry for any X.25 Gateway defined. 

The following response is generated if an X.25 switch is defined, but none 
explicitly for an X.25 Gateway: 

No X.25 switch definition entry for X.25 Gateway < gateway _name> is 
defined. 

The following error responses are generated upon an error condition: 

-ERROR- An X.25 switch definition entry for the called DTE address 
< called _dte_address> is not defined for X.25 Gateway < gateway _ 
name>. 

-ERROR- X.25 Gateway < gateway _name> is not defined. 

—ERROR— X.25 Gateway < gateway _name> may not appear more than 
once in the list of specified X.25 Gateways. 

-ERROR- Called DTE address < called _dte_address> may not appear 
more than once in the list of specified called DTE addresses. 

-ERROR- The called DTE address < called _dte .address > contains 
invalid characters. 

-ERROR- The called DTE address < called _dte .address > has an 
invalid bracketed expression. 

-FATAL- Not enough memory available for required table space. 
Examples display_x25_ switch 

X.25 Switch Definition Entries for X.25 Gateway X25_GW_SWITCH 

Called DTE Addresses 123745 [5-7165* 

12345 
Peer VE Outcal 1 Title OUTBOUND_SWITCH 

Called DTE Addresses 987?45[5-7]65* 

Peer VE Outcal 1 Title 0UTB0UND_SWITCH_2 

X.25 Switch Definition Entries for X.25 Gateway X25.SWITCH 

Called DTE Addresses 123?45[5-7]65* 

98765 
Peer VE Outcal 1 Title OUTBOUND.SWITCH 



d1splay_x25_sw1tch PEER_X25_GW 

No X.25 switch definition entry for X.25 Gateway PEER_X25_GW Is 
defined. 



d1splay_x25_sw1tch gateway_name=PEER_X25_GW called_dte_addresses=' 123456' 

—ERROR— An X.25 switch definition entry for the called DTE address 
123456 is not defined for X.25 Gateway PEER_X25_GW. 
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DISPLAY_X25 ..TERMINAL _GW (DISXTG) 
NETOU Command 

Purpose Displays the configuration of an X.25 Terminal Gateway. The display 

returns the CDCNET title, by which the gateway is known in the catenet, 
and other pertinent configuration information. 

Format DISPLAY_X25 .TERMINAL _GW 

GATEWAY JVAME = list 1..15 of name 
DISPLAY _OPTION = list of keyword value 

Parameters GATEWAY J^AME (GN) 

Specifies the logical name of one or more X.25 terminal gateway 
definitions. Default displays the configuration of all X.25 terminal gateways 
defined for the system. 

DISPLAY JOPTION (DO) 

Specifies one or more of the gateway attributes for display. These 
attributes are defined by parameters on the DEFXT command that 
configured the line. For more information on these parameters, see the 
DEFXT command description in this manual. The following keyword values 
are allowed: 

TRUNK _NAME (TN) 

TITLE (T) 

OUTCALL .DEFINITION .REQUIRED (ODR) 

ALL (A) 

Default is ALL. 
Responses The following header precedes the options display (see example). 
X.25 terminal gateway options 
If errors occur, one of the following responses appears. 
X.25 terminal gateway <name> is not defined. 
No X.25 terminal gateway is defined. 
Examples display_x25_terminal_gw 

X.25 terminal gateway options 
gateway_name ■ DATAPAC_TERMINAL_GATEWAY 
trunk_name = (DATAPAC.TRUNK) 
title = DATAPAC_ACCESS 
outcall_defin1t1on_requ1red = FALSE 
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DISPLAY_X25 JTERMINAL GW OUTCALL (DISXTGO) 
NETOU Command 

Purpose Displays the outeall configuration of an X.25 terminal gateway. The display 
returns the outeall information associated with the gateway name. 

Format DISPLAY_X25 .TERMINAL _GW_OUTC ALL 

GATEWAY JVAME = list 1..15 of name or ALL 
DISPLAY JOPTION = list of keyword value 

Parameters GATEWAY ^NAME (GN) 

Displays the names of the X.25 terminal gateways which provide access to 
remote applications. Defaults to ALL. 

DISPLAY JDPTION (DO) 

Displays one or more of the outeall attributes. These attributes are defined 
by parameters on the DEFXTG command that configured the line. For 
more information on these parameters, see the DEFXTG command 
description in this manual. The allowed keyword values are: 

OUTCALL_NAME (ON) 
REMOTE _DTE .ADDRESS (RDA) 
LOCAL_DTE .ADDRESS (LDA) 
FACILITIES (F) 
USER_DATA (UD) 
ALL (A) 

Default is ALL. 
Responses —ERROR- X.25 terminal gateway <name> is not defined. 

-ERROR- No X.25 terminal gateway is defined. 
Examples d1splay_x25_terminal_gw_outcal 1 

X.25 terminal gateway outeall options 
gateway_name = TELENET_TERMINAL_GATEWAY 

outcall_name = SOLVER 1 
remote_dte_address = 311040800146 
local_dte_address « none 
facilities = none 
user_data = none 

outcall_name = RANGE_408 
remote_dte_access = 3110408* 



1 oca 1 _dt e.addr ess 
facilities ■ none 
user.data = none 



none 
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DISPLAY_X25 JTRUNK .OPTIONS (DISXTO) 
NETOU Command 

Purpose Displays the configuration of X.25 trunks. An X.25 trunk is addressed by 

its trunk name. If a trunk name is not entered, the configuration of all 
X.25 trunks defined for the system is displayed . 

Format DISPLAY.X25 JTRUNK .OPTIONS 

TRUNK _NAME = list 1..15 of name 
DISPLAY jOPTION = list of keyword value 

Parameters TRUNK _NAME (TN) 

Specifies the logical name of an X.25 trunk assigned via a DEFINE _X25_ 
TRUNK command. 

DISPLAY jOPTION (DO) 

Specifies one or more of the trunk attributes for display. The following 
keyword values are allowed: 

LIM (L) 

PORT (P) 

TRUNK _NAME (TN) 

MODE (M) 

MAX_UNACK_FRAMES (MUF) 

PF_RECOVERY_TIMER (PRT) 

ERROR _RECOVERY_TIMER (ERT) 

RETRANSMISSION _LIMIT (RL) 

TRUNK _SPEED (TS) 

CLOCKING (C) 

INTERACTIVE .BANDWIDTH (IB) 

DRIVER (D) 

MAX_FRAME_SIZE (MFS) 

ALL (A) 

Default is ALL. 

Responses The following header precedes the options status display (see example). 

X.25 Trunk options 
If errors occur, one of the following responses appears. 

Trunk <name> is not defined. 

Trunk <name> is not an X.25 trunk. 

No X.25 trunks are defined for this system. 
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Examples d1splay_x25_trunk_opt1ons tn=x25_telenet_1 

X.25 Trunk options 
11m = 3 
port = 1 

trunk.name = X24_TELENET_1 
mode = DTE 
max_unack_f rames = 7 
pf_recovery_t1mer = 500 
retransm1ss1on_1im1t ■ 20 
trunk_speed = 19200 
clocking * Internal 
interact Ivejaandwidth = 7 
driver = hd1c_normal 
max_frame_size = 71500 
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EXEET, HELP, IDLSD, IDLTS, and KILS 
Commands 9 

EXECUTE _ECHO_TEST (EXEET) 9-2 

HELP 9-3 

IDLE .SERVER .DEVICES (IDLSD) 9-4 

IDLEJTELNETJ3ERVER (IDLTS) 9-5 

KILL_SYSTEM (KILS) 9-6 
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EXEET, HELP, IDLSD, IDLTS, and KILS 
Commands 9 

This chapter provides complete descriptions of CDCNET commands beginning with the 
letter E through K. Command descriptions are organized alphabetically by full 
command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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EXECUTE _ECHO TEST (EXEET) 
NETOU Command 

Purpose Executes the inline diagnostic path test between any two CDCNET OSI 
systems. This test does not involve sending any data. 

There is no STOP command for this test. Instead, a response is issued by 
the command processor indicating the test status. The response includes 
the destination system name tested. 

Format EXECUTE _ECHO _TEST 

DESTINATIOnIsYSTEM = name 

Parameters DESTINATION .SYSTEM (DS) 

Specifies the system name of the OSI systems to be verified. 



Responses 



Remarks 



Examples 



Echo Test to < destination _system> PASSED. Response time (msec.) = 
< integer > 

--ERROR-System < destination _sy stem > is unknown. 

-ERROR-Source system < system _name> is NOT a CDCNET OSI system. 

-ERROR-Destination system < system _name> is not a CDCNET OSI 
system. 

-ERROR-Echo Test to < destination .system > FAILED. < one line of 
additional error message > 

"Unsuccessful CLNS Data Request." 

"No response from the Destination System." 

"Destination System is NOT a CDCNET OSI system." 

"No Echo Test Task ID Table Space Available." 

"System Error - No data buffers available." 

The only restriction on the path used to to reach the destination system is 
that all systems in the path must be OSI systems. The path selection is 
done by CLNS software. 

The following example verifies that a path exists between the two DIs on 
system name tdi_e3. 

exeet ds=td1_e3 

Echo Test to TDI.E3 PASSED 
Response time (msec) = 3420 



9-2 CDCNET Commands 



60000414 C 



HELP 



HELP 

NETOU Command 

Purpose Performs the same function as the DISPLAY_COMMAND_LIST command. 
Refer to the DISPLAY_COMMAND_LIST command in this manual. 

Format HELP 

Parameters None. 

Responses Alphabetical list of all network commands (see example). 

Examples help 

add_np_gw_outcal 1 add_x25_gw_outcal 1 



unload_module wr1te_term1nal_message 
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IDLE _SERVER .DEVICES (IDLSD) 
NETOU Command 

Purpose Specifies the servers which are to be gradually idled down. 

Format IDLE ..SERVER _DE VICES 

TITLES = list of name or ALL 
IDLE_MESSAGE = list 1..4 of string 

Parameters TITLES (T) 

Specifies the title or titles of the servers for which access is to be 
gradually idled down. Default is ALL, meaning that access to all servers is 
to be idled down. 

IDLE_MESSAGE (IM) 

Specifies the text string to be sent to users that attempt to access the 
idled servers specified by the titles parameter. Default is the empty string. 

Responses Server Devices are idled. 

-WARNING-No Server Devices were found. 

-WARNING- Server Devices < title > already idled. 

-ERROR- Server Devices < title > not defined. 
Examples i d 1 e_ser ver _dev i ces 

Server Devices are idled. 
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IDLE _TELNET_SERVER (IDLTS) 
NETOU Command 

Purpose Performs a gradual shutdown of access to one or more TELNET servers. 
Users currently connected to servers at the time this command is issued, 
are allowed to complete their existing sessions. New connections are not 
allowed until a corresponding RESUME _TELNET_SERVER command is 
executed. 

Format IDLE _TELNET_SERVER 

SERVER _JfAME = list of name(s) or ALL 

Parameters SERVER _tfAME (SN) 

Specifies the names of the servers for which access is to be gradually idled 
down. Default is ALL. 

Responses TELNET server <server_name> is idled. 

-WARNING- No TELNET servers were found. 

-WARNING- TELNET server < server _name> is already idled. 

-WARNING- TELNET server < server _name> was not found. 
Examples 1d1e_telnet_servers (ARH1, ARH2, ARH3) 

TELNET server ARH1 Is Idled. 

—WARNING— TELNET server ARH2 1s already Idled. 

—WARNING— TELNET server ARH3 was not found. 

1dle_telnet_servers 

—WARNING— No TELNET servers were found. 
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KILL_SYSTEM (KILS) 
NETOU Command 



Purpose 



Shuts off a DI's system hardware clock without a graceful shutdown. You 
must reload the DI software. You may optionally request a dump of DI 
memory contents. 



NOTE 



Notify all active users that they are going to be disconnected from 
CDCNET services by sending them a message using the WRITE _ 
TERMINAL .MESSAGE command described in this manual. 



Format 



KILL .SYSTEM 

DUMP = boolean 
COMPRESS JDUMP = boolean 



Parameters DUMP (D) 

Requests a full DI memory dump before reload. Possible parameter values 
are YES and NO. Default is NO. 

COMPRESS .DUMP (CD) 

Requests a compressed dump (omits free memory and buffers) of DI 
memory. Possible parameter values are YES and NO. Default is YES. 

Responses System being reset and reloaded. 

Remarks The KILL_SYSTEM command is one of the error conditions defined for 
DIs. KILL_SYSTEM with a dump is assigned DI error condition code 32 
hexadecimal; KILL .SYSTEM without a dump is assigned error condition 
code 33 hexadecimal. These error conditions are significant in the 
configuration process for a DI, as they can be used when defining the 
loading and dumping conditions for a DI. For more information see the 
CDCNET Configuration Guide. 

Examples senc c='k1 1 l_system',s=north_tdi_1 
System being reset and reloaded. 
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LOAD_FILE (LOAF) 10-2 

LOAD .MODULE (LOAM) 10-4 

RESUME _SERVER .DEVICES (RESSD) 10-6 

RESUME _TELNET_SERVER (RESTS) 10-7 
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This chapter provides complete descriptions of the CDCNET Network Operations LOAD 
and RESUME commands. Command descriptions are organized alphabetically by full 
command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 



60000414 F LOAF, LOAM, RESSD, and, RESTS Commands 10-1 



LOAD_PILE (LOAF) 



LOAD_FILE (LOAF) 

DI Configuration/NETOU Command 



Purpose 



Format 



Makes a CDCNET file Dl-memory-resident. The file types which can be 
loaded are EXCEPTION _LIST, TERMINAL .DEFINITION .PROCEDURE 
TERMINAL_USER_PROCEDURE, DEVICE _LOAD_PROCEDURE, and ' 
VALIDATION. 

Changing file residence affects only file references performed by the DI 
where LOAD_FILE is executed. Making a file DI resident allows faster 
access and does not require a CYBER host once the file is loaded. Thus, 
certain files, such as TUPs needed for the Interactive Passthrough 
Gateway, can be accessed even if there is no active CYBER host available. 

Since the file is stored in a buffer chain, the memory used is more than 
the actual file size (there is a 46-byte overhead for each data buffer 
allocated by the system). If you use abbreviated command and parameter 
names, text files can be stored using less memory. 

If the memory required to load the file is unavailable, an error message is 
issued. When this happens while loading a new version of a file already 
residing in DI memory, the old version remains in DI memory and is used 
to satisfy subsequent file requests. If you don't want this to happen, you 
can unload the old file using UNLOAD_FILE. Once the file is unloaded, 
subsequent file requests are satisfied from a file version not residing in the 

NOTE 



Control Data strongly recommends using LOAD_FILE to load a TUP for a 
passthrough port into DI memory. Loading the TUP into DI memory 
ensures that the TUP, which must be frequently accessed and executed for 
a passthrough configuration, is available at all times. Once the TUP is 
loaded into DI memory, the TUP's availability is not subject to a CYBER 
host's availability. 



LOAD_FILE 

FILE = name or string 1..63 
FILE __TYPE = keyword value 
MAXIMUM _FILE _SIZE = integer 1..65000 
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LOAD_FILE (LOAF) 



Parameters FILE (F) 

The name of the file to be loaded. If the named file already resides in the 
DI, it is reloaded with a new, possibly different, copy. 

File names entered as strings are converted to all uppercase and are 
restricted to the character set of SCL type name. 



FILEJTYPE (FT) 

A file type. Valid file types include the following: 

Keyword Value Description 



EXCEPTION _LIST, EL, 
EXCEPTION 

TERMINAL .DEFINITION _ 
PROCEDURE, TDP, 
TERMINAL .PROCEDURE 

TERMINAL _USER_ 
PROCEDURE, TUP, USER_ 
PROCEDURE 

DEVICE _LOAD_PROCEDURE, 
DLP, LOAD_PROCEDURE 



VALIDATION 

The default is TERMINAL _USER .PROCEDURE 

NOTE 



Exception list 

Terminal definition procedure (TDP) 

Terminal user procedure (TUP) 

Device load procedure 
User validation 



The format of VALIDATION file names is , username@domain , . Both 
username and domain are 1..31 characters and must be specified. 

MAXIMUM _F1LE _$IZE (MFS) 

The maximum number of bytes of DI memory that the requested file can 
consume (see preceding information under Purpose). A file larger than this 
value cannot be loaded into a DI. Default is 2500 bytes. 

Responses File <name> is loaded, size is <nnnnnn> bytes. 

-ERROR— Maximum size for file <name> is exceeded, size is <nnnnnn> 
bytes. 

-ERROR- Unable to locate file <name> with file type <type>. 

-ERROR— Unable to load file <name>, <file access error template > [file 
source system-id is < system-id >]. 

-FATAL- Not enough system buffers are currently available to load file 
<name>, size is <nnnnnn> bytes. 

Examples 1oad_f1le f=pr1nter_w1th_vfu_p31310 ft*termlnal_procedure 

File printer _v»1th_vfu_p31310 1s loaded from systeml, size 
1s 2500 bytes. 
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LOAD_MODULE (LOAM) 

DI Configuration/NETOU Command 

Purpose Loads a specified software module and optionally sets the module load 
status to retained. If the software module is already loaded, the LOAD_ 
MODULE command sets only the retain status for the module; it does not 
guarantee that a new copy of the module is loaded. A retained module is 
not unloaded to recover system memory resources, even if the module is 
unused and memory resources are scarce. 

Format LOAD_MODULE 

MODULE = name 
ENTRY^POINT = name 
RETAIN = boolean 

Parameters MODULE (M) 

The name of the desired software module. 

ENTRY JPOINT (EP) 

The entry point name used to determine which module to load from the DI 
library. 

RETAIN (R) 

The retain status for the module. Default is YES, retain. 
Responses Module < module > loaded. 

Module < module > loaded and retained. 
-WARNING- Module < module > previously retained. 
-WARNING- Declaration mismatch from module < module >. 

-ERROR- Entry point < entry point > is not contained within module 

< module >. 

-ERROR- Module < module > was not found in directory. 
-ERROR- Module for entry point < entry point > was not found. 
-ERROR- One of the parameters Module or Entry Point must be specified. 
-FATAL- On-line loader not included in boot file. 
-FATAL- Unable to access file load service. 

-FATAL- Not enough memory is currently available to load module 

< module >. 

-FATAL- Not enough buffers are currently available to load module 

< module >. 

-FATAL- Not enough buffers or memory are currently available to load 
module < module >. 

-FATAL- File access error is unrecoverable. 

-FATAL- Duplicate definition of entry point < entry point > encountered. 
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-FATAL- Identification record expected for module < module >. 

-FATAL- Premature EOF encountered on module < module >. 

-FATAL- Object text version must be < version >, but is < version >. 

-FATAL- Object text record too long in module < module >. 

-FATAL- Unrecognizable record in module < module >. 

-FATAL- Unknown record kind encountered in module < module >. 

Remarks To display the modules currently loaded in a DI, send the DISPLAY_ 

SOFTWARE _LOAD_STATUS (see description in this manual) command to 
the DI. An alternative method is to use the NPA report LOADRP1 to 
identify modules loaded per DI. See the Network Performance Analyzer 
commands in this manual for the procedure used to generate LOADRP1. 

Examples This example shows a software module containing the DISPLAY_ 

HARDWARE _STATUS (DISHS) command processor being loaded into the 
DI by the LOAD_MODULE command. This is done so that the display 
hardware status command processor is loaded in the DI and retained there. 
Then when the DISHS command is entered, it may be processed more 
quickly than it would be if the processor had to be accessed and loaded 
using the Online Loader. 

loacLmodule module=display_hardware_status 

Module DISPLAY_HARDWARE_STATUS loaded and retained. 

This example shows the command processor from example 1 being loaded 
with the RETAIN parameter set to NO. The command processor is loaded 
into the DI, but if it is not used and the memory it occupies is needed, it 
does not remain. 

load_module m=display_hardware_status r=no 
Module DISPLAY_HARDWARE_STATUS loaded. 
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RESUME _SERVER_DEVICES (RESSD) 
NETOU Command 



Purpose 



Format 



Resumes access to Passthrough and/or Device Outcall Servers that have 
had their access previously idled down. 

RESUME .SERVER .DEVICES 

TITLES = list of name or ALL 



Parameters TITLES (T) 

Specifies the title or titles of the servers for which access is to be 
resumed. Default is ALL, meaning that access to all servers is to be 
resumed. 

Responses Server Devices are resumed. 

-WARNING- Server Devices < title > not idled. 

-ERROR- Server Devices < title > not defined. 
Examples resume_server_dev1ces 

Server Devices are resumed. 
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RESUME_TELNETJ3ERVER (RESTS) 

RESUME .TELNET ^SERVER (RESTS) 
NETOU Command 

Purpose Resumes access to TELNET servers that have had their access previously 

idled down. 

Format RESUME JTELNET .SERVER 

SERVER JSfAME = list of name(s) or ALL 

Parameters SERVER _J>IAME (SN) 

Specifies the names of the servers for which access is to be resumed. 
Default is ALL. 

Responses TELNET server < server _name> is resumed. 

-WARNING- No TELNET servers were found. 

-WARNING- TELNET server < server _name> is not idled. 

-WARNING- TELNET server < server _name> was not found. 
Examples resume_telnet_servers (ARH1, ARH2, ARH3) 

TELNET server ARM 1s resumed. 

—WARNING— TELNET server ARH2 is not idled. 

—WARNING— TELNET server ARH3 was not found. 

r esume_t e 1 net .server s 

—WARNING— No TELNET servers were found. 
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This chapter provides complete descriptions of the following CDCNET commands: 

SEND .DIAGNOSTIC _DATA (SENDD) 
SET_DATE_AND_TIME (SETDAT) 

Command descriptions are organized alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 



60000414 C SENDD and SETDAT Commands 11-1 



SEND JDIAGNOSTICJJATA. (SENDD) 

SEND_DIAGNOSTIC JDATA (SENDD) 
NETOU Command 

Purpose Sends a diagnostic data string to a LIM port. Use this command to send 

commands to an intelligent modem on an asynchronous line. Place the LIM 
port in the DOWN state before executing this command. 

Format SEND .DIAGNOSTIC DATA 

DEVICE .NAME = name 
DATA = string of 1..64 
CARRIAGE JRETURN = boolean 
RESPONSE JTIMEOUT = integer 1..10 

Parameters DEVICE .NAME (DN) 

Specifies the physical name of the device. The name consists of the 
keyword LIM, the LIM board slot number, the keyword PORT, and the 
port number on the LIM. 

DATA (D) 

Specfies the desired diagnostic data string to be sent to the LIM port. The 
data string must be enclosed in two single quotes. Thus, when the data 
string ends the command, two single quotes end the data string and a 
third single quote ends the entire command. See the Examples below. 

CARRIAGE JtETURN (CR) 

Specifies a flag indicating whether a carriage return should be appended to 
the diagnostic data string. Default is TRUE. 

RESPONSE JTIMEOUT (RT) 

Specifies the time in seconds to wait for the intelligent modem to return 
its response. Default is 1 second. 

Responses Response data follows: < response data> 

-WARNING- Device < device _name> test already started. 

-WARNING- Response data was not received. 

-ERROR- Expecting device name $LIMx_PORTx, found < device _name> 

-ERROR- Device < device .name > not installed in system 

-ERROR- Device < device .name > not in "DOWN" state. 

-ERROR- Configured line is not ASYNC. 

-FATAL- Aborted trying to start up line. 

Examples sencLd 1agnost1c.dat a devlce_name=$LIM4_PORT0 D="ATU0" 

Response data follows: 

The following example illustrates how to use the SEND .DIAGNOSTIC. 
DATA command to test an intelligent modem without using the existing 
online port diagnostic. 
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Place the port in the DOWN state, with the CHANGE _ELEMENT_ 
STATE command. 

change.element .state dev1ce_name*$LIM0_PORT0 .. 
s=down 

The following response appears: 

Device $11m0_port0 down 

Place the modem in local analog loopback mode with the SEND_ 
DIAGNOSTIC _DATA command. 

send d1agnost1c_data dn=$LIM0_PORT0 .. 
data«"ATU0" RT=1 

The following response appears: 

Response data follows: 

ATUO 

Send a data string to the modem, with the SEND ..DIAGNOSTIC. 
DATA command. The data should loop back to the modem. 

send_diagnost1c_data dev1ce_name=$LIM0_PORT0 .. 
dat a= ' ' UUUUUUUUUUUUUUUUUUUU ' ' 

The following response appears: 

Response data follows: 

UUUUUUUUUUUUUUUUUUUU 

Terminate the modem local analog loopback mode with the SEND_ 
DIAGNOSTIC _DATA command. 

send_diagnost1c_data device_name=$LIM0_PORT0 .. 
data="+++"carriage_return*FALSE 

The following response appears: 

Response data follows: 



60000414 C SENDD and SETDAT Commands 11-3 



SEND .DIAGNOSTIC _DATA (SENDD) 



Return the port to the ON state with the CHANGE _ELEMENT_ 
STATE command. 

change_element .state dev1ce_name=$LIM0_PORT0 .. 
state=ON 

The following response appears: 

Device $UmO_portO on 

The following example illustrates how to use the SEND .DIAGNOSTIC _ 
DATA command to test an intelligent modem with the existing online port 
diagnostic in modem loopback mode. 

Put the port in the DOWN state with the CHANGE _ELEMENT_ 
STATE command. 

change_element_state dev1ce_name=$LIM0_PORT0 .. 
state=DOWN 

The following response appears: 

Device $HmO_portO down 

Place the modem in local analog loopback mode with the SEND_ 
DIAGNOSTIC _DATA command. 

send_diagnostic_data device_name=$LIM0_PORT0 .. 
data="ATUO" 

The following response appears: 

Response data follows: 

ATUO 

Execute the port online diagnostic in modem loopback mode with the 
START_PORT_TEST command. 

start_port_test dev1ce_name=$LIM0_PORT0 . . 
loop_mode=MODEM success_state=DOWN modem_class««4 

NOTE 

The example assumes the test passes. SUCCESS _STATE = DOWN is 
required to eliminate the need for another CHAES command to place 
the port in the DOWN state. MODEM_CLASS=4 is needed if the line 
(port) is undefined or defined as an auto_rec line. 



Terminate modem local analog loopback mode and return port to the 
ON state as in previous example. 
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SET_DATE _AND _TIME (SETDAT) 
NETOU Command 

Purpose Sets the master date and time for a catenet. For NOS-based CDCNET 

environments, the master date and time is maintained by one DI in the 
network that is configured as the clocking _sy stem DI. A clocking _system 
DI contains the Independent Clock Management Entity. For NOS/VE-based 
CDCNET environments, the master date and time is maintained in a 
NOS/VE host. For NOS environments, this command must be sent to the 
clocking _system DI. 

Each CDCNET DI reports date and time in command responses, logs, and 
alarms. Each DI also contains a Dependent Clock ME, which obtains the 
master Catenet clock from the clocking _system DI (or from the master 
clock on the NOS/VE host in NOS/VE environments). When the correct 
date and time are set, you can send the SYNCHRONIZE _CLOCK 
command to each DI in the network (see SYNCHRONIZE _CLOCK 
command description in this manual), to reset each DI's clock to the 
master date and time. 

Format SETJDATE. AND _TIME 

DATE = string 
TIME = string 

DATE_FORMAT = keyword value 
TIMEJFORMAT = keyword value 

Parameters DATE (D) 

Current date, represented in the format specified by the DATE_FORMAT 
parameter (see parameter description). If this parameter is not entered, the 
CDCNET date is not changed. The allowable range for the day component 
is depends on the month and year. Range for January, March, May, July, 
August, October, December is 1..31; for April, June, September, November, 
1..30; and for February, 1..28 or 1..29. The allowable range for the month 
component is 01..12. If the DATE .FORMAT selected is ISO, the ISO year 
range is 1900..2155. 

TIME (T) 

Current time, represented in the format specified by the TIME_FORMAT 
parameter (see parameter description). If time is not entered, the current 
time is used. The allowable range for the minute and second components is 
00..59. If the TIME .FORMAT selected is AMPM, the hour component may 
be in the range 01. .12, otherwise the range is 00..23. 
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DATE_FORMAT (DF) 

Specifies how date information is specified. Allowed keyword values include 
the following, using as an example a date of November 1, 1985, and dd for 
day, mm for month, and yy for year. 



Keyword Value 


Format 


Example 


MDY 


mm/dd/yy 


11/01/85 


DMY 


dd/mm/yy 


01/11/85 


ISO 


yyyy-mm-dd 


1985-11-01 


Default is DMY. 







TIME FORMAT (TF) 

Specifies how time information is specified. Allowed keyword values include 
the following, using as an example a time of 2:41 PM, and hh for hour, 
mm for minute, ss for second, and XX for AM or PM identifier. 

Keyword Value Format Example 



AMPM hh:mm XX 2:41 PM 

HMS hh:mm:ss 14:41:38 

Default is HMS. 

Responses The following header precedes the date and time in selected format (see 
example). 

Master clock for catenet set. 

If an error occurs, one of the following headers appears. 

-WARNING- Master clock for catenet set 
(Followed by date and time in selected format) 
Power on reset <text> used, please correct. 

-WARNING- Master clock for catenet set 
(Followed by date and time in selected format) 
Power on reset date and time used, please correct. 

-ERROR- Alphabetic character in date: <text>. 

-ERROR- Alphabetic character in time: <text>. 

-ERROR- Day value <text> out of range. 

-ERROR- Day value <text> out of range for month <text>, year 
<text>. 
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-ERROR- Month value <text> out of range. 

-ERROR- Year value <text> out of range. 

—ERROR- Hour value <text> out of range. 

—ERROR- Minute value <text> out of range. 

—ERROR- Second value <text> out of range. 

-ERROR- Expecting date in format <text>, found <text>. 

-ERROR- Expecting time in format <text>, found <text>. 

—ERROR- Independent clock ME not installed in system. 

Remarks The clocking .system DI is configured by the CLOCKING _SYSTEM 

parameter on the DEFINE _SYSTEM command described in this manual. 
To determine which DI is configured to be the clocking _sy stem, send the 
DISPLAY_SYSTEM .OPTIONS (DISSO) command, described in this 
manual, to each DI. Specify the display option CLOCKING .SYSTEM, as 
shown in the following example. 

SEND.COMMAND SYSTEM=d1_name,COMMAND='DISPLAY_SYSTEM_OPTIONS. . 
DISPLAY_OPTION=CLOCKING_SYSTEM' 

The DI that contains the master clock returns the following response. 

clocking_system » yes 

If any component of the date or time is omitted, the corresponding 
component of the current date or time is used. For example, if you enter 
df=dmy,d=7/86", the year changes to 1986, but the current day and 
month do not change. Leading zeros may be omitted from any component 
number, provided that the component is preceded by a delimiter or a 
letter. The following are valid delimiters. 



blank 


space 


/ 


slant 


- 


hyphen 


: 


colon 



Examples set_date_and_time d»"24/11/85", .. 
t»"08:25:49" 

Master clock for catenet set 
24/11/85 08:25:49 
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START_CIM_TEST (STACT) 12-2 
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This chapter provides complete descriptions of all CDCNET Network Operations START 
commands. Command descriptions are organized alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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START.CIM_.TEST (STACT) 
NETOU Command 

Purpose Starts an online diagnostics test for a Communications Interface Module 
(CIM), all its connected URIs and LIM boards, and their ports. 

The CIM diagnostic test should be used only if there are problems on more 
than one LIM, since all line users must be disconnected and lines must be 
stopped to run the CIM diagnostic. If problems seem to be confined to one 
LIM, the LIM test should be run (see START_LIM_TEST command later 
in this chapter), and if no errors occur while running the LIM test, the 
Port test should be run (see START_PORT_TEST command later in this 
chapter). 

Format START_CIM JTEST 

DEVICE _NAME = keyword value 

REPEAT_PASS = integer 0..65535 
SUCCESS _STATE = keyword value 
LOGGING = boolean 
STOP_ON_ERROR = boolean 

Parameters DEVICE _NAME (DN) 

The physical name of the CIM being tested. This name consists of a dollar 
sign $, the board type (CIM), and the board slot number (0..7), as in 
$CIM3 for a CIM board in slot 3. 

REPEAT _PASS (RP) 

Specifies how many times you want the test to repeat (pass). The value 
specifies that the test is run continuously until you stop the test by a 
STOP_CIM_TEST command described in this manual. Default is 1. 

NOTE 



If the STOP_ONJERROR parameter is set to OFF, an error causes the 
test to terminate the current pass and restart testing at the beginning of 
the next pass. 



SUCCESS _STATE (SS) 

Determines the state in which the hardware device is left upon successful 
completion of the diagnostic test. Possible values are ON and DOWN. ON 
specifies that the device state is set to ON if the test completes without 
error, but remains set to the DOWN state if the test detects an error. 
DOWN specifies that the state remains set to DOWN regardless of the test 
outcome. Default is ON. 
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LOGGING (L) 

Specifies whether you want the diagnostic messages logged in a log file. 
There are two possible values for this parameter: ON and OFF. ON 
specifies that diagnostic messages are logged in the log file. OFF specifies 
that diagnostic messages are not logged. Default is ON. 

STOP_ON_ERROR (SOE) 

Specifies whether or not you want the test to end if an error condition is 
encountered. There are two possible values for this parameter: ON and 
OFF. ON specifies that the test is stopped if any error occurs. OFF 
specifies that the test is not stopped if any error occurs. See note with the 
REPEAT_PASS parameter. Default is ON. 

Responses The following message is a success response. 

CIM test started, version < version _number>. CIM slot number = 
<cim slot number >. 

If an error occurs, one of the following messages is received. 

-WARNING- Device < device _name> test already started. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- Device <device_name> not in "DOWN" state. 

-FATAL— CIM test aborted, version < version _number>. CIM slot 
number = <cim slot number > Unable to start test task. 

—FATAL— CIM test aborted, < version number >. CIM slot number = 
<cim slot number >. Test task stop flag set. 

Remarks In order for this test to run, the device state must be DOWN. Use the 
CHANGE _ELEMENT_STATE command, described in this manual, to 
change the state of the device. 

To get the results of the CIM test, send the DISPLAY_TEST_STATUS 
command, described in this manual, to the DI that contains the device 
being tested. 

If you start the CIM test, and the CIM test runs without failure, you do 
not also have to start the LIM test using START_LIM_TEST (described in 
this chapter). However, you should still run the port test (using START. 
PORTJTEST described in this chapter), using the EXTERNAL and 
MODEM loop mode options, to check for problems outside of the CIM and 
LIM, such as communication line and modem problems. 

You can best test LIM select logic failures by running multiple port tests 
concurrently, using the START_PORT_TEST command described in this 
manual. Running the CIM or LIM tests only tests the ports sequentially. 
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Examples This example starts an online diagnostics test for a CIM and all its LIMs, 
running one pass of the test and stopping on the first occurrence of an 
error. 

start_dm_test device_name=$c1m5 

CIM test started, version 0901 
CIM slot number = 5 

This example starts an online diagnostics test for a CIM and all its LIMs. 
The test is run continuously without stopping for errors. However, since 
logging is on, any errors encountered during the test are logged. 

start_dm_test dn=$c1m5,rp=0,soe=off 

CIM test started, version 0901 
CIM slot number = 5 
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START_EGP_PEER (STAEP) 
NETOU Command 

Purpose Starts Exterior Gateway Protocol (EGP) processing for the specified peer. If 
the peer has not already been acquired and the peer was defined as AUTO 
or MANUAL mode (see the PEER_USAGE parameter of the DEFINE. 
EGP_PEER command described in this manual), then EGP attempts to 
acquire the peer and exchange routing information. If the peer has not 
been started and the peer was defined for BACKUP mode, the peer is 
eligible for backup duty if an active peer is lost. If the peer has already 
been started and acquired, EGP generates a 'start' event that forces EGP 
to reacquire the peer. 

Format START_EGP_PEER 

IP_ADDRESS = list 4 of (0..255) 

Parameters IP.ADDRESS (IA) 

Identifies the IP address of the EGP peer gateway with which exchange of 
routing information is to be started. 

Responses EGP peer <ip_address> is started. 

EGP peer <ip_address> enabled for BACKUP use. 

EGP peer <ip_address> is already acquired - start event generated. 

-ERROR- EGP peer <ip_address> is not defined. 
Examples start_egp_peer 1p_address = (128,5,0,3) 

EGP peer 128.5.0.3 1s started. 
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START_ESCI JTEST (STAET) 
NETOU Command 

Purpose Starts the online diagnostics test on an ESCI board. The ESCI diagnostic 
test can be used to isolate possible failures on an ESCI board or Ethernet 
transceivers. 

An online diagnostics test affects only the board being tested. Operations 
and communications traffic for other boards or ports are unaffected. 
However, during a test the board or port is not available for normal 
communications traffic. This means that you may not execute online 
diagnostics on the only board or port supporting the network solution over 
which the DI receives operations commands from you. This restriction is 
enforced through the STOP_NETWORK command described in this manual; 
since communications must be stopped on the device being tested before 
the diagnostics can be executed. 

Format START_ESCI _TEST 

DEVICE _NAME = keyword value 

REPEAT_PASS = integer 0..65535 
SUCCESS _STATE = keyword value 
LOGGING as boolean 
STOP_ON _ERROR = boolean 

Parameters DEVICE _NAME (DN) 

The physical name of the ESCI being tested. This name consists of a dollar 
sign $, the board type (ESCI), and the board slot number (0..7). For 
example, $ESCI4 is the physical name for a ESCI board in slot 4. This 
parameter has no default parameter. 

REPEAT_PASS (RP) 

Specifies how many times you want the test to repeat. The value 
specifies that the test is run continuously until you stop the test by a 
STOP_ESCI_TEST command described in this manual. Default is 1. 

NOTE 



If the STOP_ON_ERROR parameter is set to OFF, an error causes the 
test to terminate the current pass and restart testing at the beginning of 
the next pass. 



SUCCESS J3TATE (SS) 

Determines the state in which the hardware device is left upon successful 
completion of the diagnostic test. Possible values are ON and DOWN. ON 
specifies that the device state is set to ON if the test completes without 
error, but remains set to the DOWN state if the test detects an error. 
DOWN specifies that the state remains set to DOWN regardless of the test 
outcome. Default is ON. 

LOGGING (L) 

Specifies whether you want the diagnostic messages logged in a log file. 
There are two possible values for this parameter: ON and OFF. ON 
specifies that diagnostic messages are logged in the log file. OFF specifies 
that diagnostic messages are not logged. Default is ON. 
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STOP_ON_ERROR (SOE) 

Specifies whether or not you want the test to end if an error condition is 
encountered. There are two possible values for this parameter: ON and 
OFF. ON specifies that the test is stopped if any error occurs. OFF 
specifies that the test is not stopped if any error occurs. See note with the 
REPEAT_PASS parameter. Default is ON. 

Responses The following message is a success response. 

ESCI test started, version < version _number>. 
ESCI slot number = <esci slot number tested >. 

If an error occurs, one of the following messages is received. 

-WARNING— Device < device _name> test already started. 

-ERROR— Device < device _name> not installed in system. 

-ERROR- Device <device_name> not in "DOWN" state. 

-FATAL- ESCI test aborted, version < version _number>. 
ESCI slot number = <esci slot number > 
Unable to start test task. 

Remarks In order for this test to run, the device state must be DOWN. Use the 
CHANGE _ELEMENT_STATE command described in this manual to 
change the state of the device. 

To get the results of the ESCI test, send the DISPLAY_TEST_STATUS 
command described in this manual to the DI that contains the device being 
tested. 

If you specify SUCCESS .STATE = DOWN, you must use the CHANGE _ 
ELEMENT J3TATE command described in this manual, when the diagnostic 
completes to put the device in the ON state. 

Examples This example shows an ESCI online diagnostics test being started for an 

ESCI board in slot 6 of a DI called North _TDI_1. Logging is to be turned 
off for this test and no errors are logged. 

start_esci_test device_name=$esc16, l=off 

ESCI test started, version 0901 
ESCI slot number ■ 6 
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START_LIM_TEST (STALT) 
NETOU Command 

Purpose Starts an online diagnostics test on a LIM board and its ports. 

The LIM diagnostic test should be run if failures are reported on two or 
more ports on the same LIM. If no errors occur while running the LIM 
test, the Port diagnostic test should be run (see START_PORT_TEST 
command described in this chapter). If problems are reported on more than 
one LIM, the CIM diagnostic test should be run (see START_CIM_TEST 
described in this chapter). 

Format START _LIM _TE ST 

DEVICE _NAME = keyword value 
REPEAT JPASS = integer 0..65535 
SUCCESS JSTATE = keyword value 
LOGGING = boolean 
STOP_ON_£RROR = boolean 

Parameters DEVICE _NAME (DN) 

Physical name of LIM device, consisting of a dollar sign $, board type 
(LIM) and slot number, as in $LIM5 (device name for LIM board in slot 5). 

REPEAT_PASS (RP) 

Specifies how many times you want the test to repeat. The value 
specifies that the test is run continuously until you stop the test by a 
STOP_LIM_TEST command described in this manual. Default is 1. 

NOTE 



If the STOP_ON_ERROR parameter is set to OFF, an error causes the 
test to terminate the current pass and restart testing at the beginning of 
the next pass. 



SUCCESS _STATE (SS) 

Determines the state in which the hardware device is left upon successful 
completion of the diagnostic test. Possible values are ON and DOWN. ON 
specifies that the device state is set to ON if the test completes without 
error, but remains set to the DOWN state if the test detects an error. 
DOWN specifies that the state remains set to DOWN regardless of the test 
outcome. Default is ON. 

LOGGING (L) 

Specifies whether you want the diagnostic messages logged in a log file. 
There are two possible values for this parameter: ON and OFF. ON 
specifies that diagnostic messages are logged in the log file. OFF specifies 
that diagnostic messages are not logged. Default is ON. 

STOP JON _ERROR (SOE) 

Specifies whether or not you want the test to end if an error condition is 
encountered. There are two possible values for this parameter: ON and 
OFF. ON specifies that the test is stopped if any error occurs. OFF 
specifies that the test is not stopped if any error occurs. See note with the 
REPEAT_PASS parameter. Default is ON. 
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Responses You receive the following response if the test starts successfully. 

LIM test started, version < version __number>. 
CIM slot number = <CIM slot number >. 
LIM slot number = <lim slot number >. 

The following response indicates the test has already been started. 

-WARNING- Device < device __name> test already started. 
The following responses indicate the device cannot be tested. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- Device <device_name> not in "DOWN" state. 

-ERROR- Device < device _name> cannot be tested at this time. 
$CIM <cim slot number > must be dedicated to the < driver _type> 
driver and is currently active. The STALT command may be reissued 
once all active lines/trunks on $CIM <cim slot number > are stopped. 

-FATAL- LIM test aborted, version < version _number>. 
CIM slot number = <cim slot number >. 
Unable to start test task. 

You receive the following response when the test task started but 
terminated prematurely. 

—FATAL— LIM test aborted, version < version ..number >. 
CIM slot number = <cim slot number >. 
Test task stop flag set. 

You receive the following response when the LIM test cannot run because 
all ports on the LIM are turned OFF. Use the CHANGE J3LEMENT_ 
STATE command to change the hardware to the appropriate state. See the 
CHANGE _ELEMENT_STATE command described in this manual. 

—FATAL— LIM test aborted, version < version _number>. 
CIM slot number = <cim slot number >. 
State of all ports is "OFF". 

You receive the following response when no ports are supported on the 
LIM as indicated by the LIM Status Table. This may occur if the LIM 
on-board tests fail. Use the DISPLAY_TEST_STATUS command described 
in this manual to determine the status of on-board tests. 

-FATAL- LIM test aborted, version < version _number>. 

CIM slot number = <cim slot number >. 

LIM Status Table indicates no ports supported on lim. 
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You receive the following response if the LIM specified on the last line of 
the response is not one of the following supported types. 

4-channel RS232 (xx=08 (16) through OF (16)) 
RS449 (xx=00 (16) through 07 (16)) 
V.35 (xx=20 (16) through 27 (16)) 

-FATAL- LIM test aborted, version < version _number>. 
CIM slot number = <cim slot number >. 
LIM slot number = <lim slot number >. 
Test not allowed for LIM type xx. 

As seen in the following response, there is a special case defined for CIM 
failures that prohibits starting a lower level test such as a LIM or a port 
test. That is, if the CIM has failed, you can not start a LIM test until you 
run a CIM test (using the START_CIM_TEST command described in this 
manual). 

-FATAL- LIM test aborted, version < version number >. 

CIM slot number = <cim slot number >. 

LIM slot number = <lim slot number >. 

Previous CIM failure requires CIM to be tested first. 

ENTER "start_cim_test dn= <device name>". 

In order for the LIM test to run, the device state must be DOWN. Use the 
CHANGE _ELEMENT_STATE command described in this manual to 
change the state of the device. 

To get the results of the LIM test, send the DISPLAY_TEST_STATUS 
command, described in this manual, to the DI that contains the device 
being tested. 

If you specify SUCCESS _STATE= DOWN, you must use the CHANGE. 
ELEMENT_STATE command described in this manual when the diagnostic 
completes to put the device in the ON state. 

Examples start_Hm_test device_name=$11m5 

LIM test started, version 10H3. 
CIM slot number = 6. 
LIM slot number - 5. 



Remarks 
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START_LINE (STAL) 
NETOU Command 

Purpose Starts communications over a communication line or a URI line. The 

terminal interface program (TIP) supporting the line must be defined for 
this command to succeed. 

Format START_LINE 

LINE_NAME = name 

Parameters LINE_NAME (LN) 

The logical name of the line assigned by the DEFINE JLINE configuration 
command. 

Responses Line <line_name> started. 

-ERROR- Line <line_name> already started. 

-ERROR— Line <line_name> not defined. 

-ERROR- TIP for line <line_name> not configured. 

-FATAL- Line start-up failed. 
Examples start_line line_name=line31 

Line LINE31 started. 
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START_LINE .METRICS (STALM) 
NETOU Command 

Purpose Starts the collection and optional reporting of statistics for one or more 

communication or URI lines. If statistics are already started for lines, they 
are immediately reported and the report period restarted. The line 
statistics are recorded by the terminal interface program (TIP) supporting 
the line. The Network Performance Analyzer (NPA) reports that collect line 
statistics are TERMRP1 and TERMRP2. 

Format START_LINE ..METRICS 

LINE_NAME = list 1..15 of name 
REPORT_INTERVAL = 1..86400 

GROUP = list 1..2 of keyword value 
REPORT = boolean 

Parameters LINE_NAME (LN) 

The logical names of any communication or URI lines for which statistics 
are to be collected. 

REPORT_INTERVAL (RI) 

Statistic reporting interval, specified in seconds. This parameter indicates 
how often the statistics are reported. The maximum interval is 24 hours 
(86,400 seconds). 

GROUP (G) 

Specifies the type of statistics group requested to be collected: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is SUMMARY statistics. 

REPORT (R) 

Specifies whether or not statistics should be reported by log messages. The 
messages are generated and sent to the CDCNET log file according to the 
interval set by the REPORT_INTERVAL command described in this 
manual. Possible values are YES, generate reporting log messages, and 
NO, do not generate reporting log messages. Default is YES. 
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Responses The following response indicates the test successfully started (one response 
for each line and group for which metrics was started). 

Line <line_name> < group _name> metrics started. 

The following line is also output for a metric if the log message number 
used to report that the message is not enabled for the DI. When you 
receive this message, you may enable any messages listed using the 
CHANGE __SOURCE_LOG_GROUP command described in this manual. 

Reporting log message < message _number> not enabled. 

For lines that are not defined or do not support line metrics, the following 
lines are inserted. 

Line <line_name> not defined. 

Line <line_name> < group _name> metrics not supported. 

-FATAL- Line <line_name> metrics start-up failed. 

-FATAL- Line <line_name> metrics start-up failed, not enough 
memory currently exists for required table space. 

Remarks For line statistics to be reported, log message number 166 (line statistics) 
must be enabled. To check whether this message is enabled, use the 
DISPLAY_SOURCE_LOG_MESSAGES command described in this manual. 
If it is not enabled, enable it using the CHANGE _SOURCE_LOG_ 
GROUP command described in this manual. 

See the NPA commands in this manual for information on creating 
statistics reports using the REFORMAT_CDCNET_LOG_FILE (REFCLF) 
and CREATE _CDCNET_ANALYSIS_REPORT (CRECAR) commands. 

Examples start_Hne_metr1cs ln=bld_3_async_22,g=all ,r 1=360 

Line BLD_3_ASYNC_22 summary metrics started. 
Line BLD_3_ASYNC_22 expanded metrics started. 



60000414 C 



START Commands 12-13 



START_MCI JNUNE_TEST (STAMIT) 



START_MCI ..INLINE JTEST (STAMIT) 
NETOU Command 



Purpose 



Format 



Starts the inline diagnostics testing of an MCI board. An inline diagnostics 
test shares access to the device being tested with nondiagnostic 

software, while an online diagnostics test has exclusive access to and 
control of the device being tested. 

START_MCI .INLINE JTEST 
DEVICE .NAME = name 
MESSAGE JCOUNT = 1..10000 
MESSAGE JLENGTH = keyword value 
MESSAGE INTERVAL = 0..60000 

Parameters DEVICE _NAME (DN) 

Specifies the physical name of the MCI to be tested. 

MESSAGE JCOUNT (MC) 

Specifies the number of messages to be transmitted and received as part of 
this inline test. Default is 100. 

MESSAGE JLENGTH (ML) 

Length of the test messages to be transmitted as part of the inline test. 
The following keywords are valid for this parameter. 

Nl 

N2 

N3 

N4 

N5 

N10 

N500 

N1500 

SMALL 

LARGE 

MIXED 

The keywords allow a test message to be either a fixed or relative length 
(in bytes). 

Specify one of the fixed keywords when you want all messages transmitted 
during the test to be the same length. The fixed length keywords and their 
values are as follows. 



Keyword 



Value 



Nl 


1 byte 


N2 


2 bytes 


N3 


3 bytes 


N4 


4 bytes 


N5 


5 bytes 


N10 


10 bytes 


N500 


500 bytes 


N1500 


1500 bytes 
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Specify a relative keyword when the transmitted message length can be 
within a certain range. If you select a relative value, the inline test 
diagnostic determines the test message length. The same size is not used 
for all messages. The diagnostic software distributes the test messages 
length within a range you selected. 

The relative length keywords and their values are as follows. 



Keyword 



Value 



SMALL 
LARGE 
MIXED 



1 through 500 bytes 
500 through 1500 bytes 
1 through 1500 bytes 



Default is MIXED. 

MESSAGE .JNTERVAL (MI) 

Specifies the time interval between test messages. Specify the value in 
milliseconds. The diagnostic inline software delays the specified time before 
transmitting the next test message. A parameter value of means test 
messages are transmitted as fast as possible. Default is 0. 

Responses The following message is a success response. 

MCI in line test, version < version > 
started for device < device _name> 

If an error occurs, one of the following messages is received. 

—WARNING— In line test for device < device _name> is already 
started. 

—ERROR- Device < device _name> not installed in system. 

-ERROR- Device <device_name> not in "ON" status. 

-ERROR- Device < device _name> not a MCI board. 

—ERROR- Channel trunk for device (device _name) is not defined. 

—ERROR- An NP interface, VE interface, or channel network solution 
for device < device _name> is not defined). 

—ERROR- NP interface for device < device _name> is not up. 

—ERROR- VE interface for device < device _name> is not up. 

-ERROR- Unable to start the MCI in line test. 

Not enough memory is available for the required table space. 

-ERROR- Unable to start the MCI inline diagnostics task. 

Examples start_mc1_1nl1ne_test devlce.name - $mcl7 

MCI in line test, version 2605 
started for device $mcl7 
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START JMCIJTEST (STAMT) 
NETOU Command 

Purpose Starts the online diagnostic test on an MCI board. 

NOTE 

STAMT does not work on NOS/VE channels. 



Format 



Parameters 



START_MCI_TEST 

DEVICE _NAME = keyword value 

REPEAT_PASS = integer 0..65535 
SUCCESS _STATE = keyword value 
LOGGING = boolean 

DEVICE .NAME (DN) 

Physical name of the MCI to be tested. The physical name consists of a 
dollar sign $, board type (MCI), and the slot number, as in $MCI6 (device 
name for an MCI in slot 6). There is no default value. 

REPEAT J>ASS (RP) 

Specifies how many times you want the test to repeat. The value 
specifies that the test is run continuously until you stop the test by a 
STOP_MCI_TEST command described in this manual. Default is 1. 

SUCCESS _STATE (SS) 

Determines the state in which the hardware device is left in upon 
successful completion of the diagnostic test. Possible values are ON and 
DOWN. ON specifies that the device state is set to ON if the test 
completes without error, but remains set to the DOWN state if the test 
detects an error. DOWN specifies that the state remains set to DOWN 
regardless of the test outcome. Default is ON. 

LOGGING (L) 

Specifies whether you want the diagnostic messages logged in a log file. 
There are two possible values for this parameter: ON and OFF. ON 
specifies that diagnostic messages are logged in the log file. OFF specifies 
that diagnostic messages are not logged. Default is ON. 
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Responses The following message is a success response. 

MCI test started, version < version number >. 
MCI slot number = <mci slot number >. 

If an error occurs, one of the following messages is received. 

-WARNING- Device < device _name> test already started. 

-ERROR— Device < device _name> not installed in system. 

-ERROR- Device < device _name> not in "DOWN" state. 

-ERROR- Device <name> test already started. Only one MCI test is 
allowed to be active at one time. Stop Active test or wait for it to 
complete. 

-FATAL- MCI test aborted, version < version number > MCI slot 
number = <mci slot number > Unable to start test task. 

-FATAL- MCI test aborted, version < version number > MCI slot 
number = <mci slot number > Test task stop flag set. 

Examples start_mci_test device_name=$mci7 

MCI test started, version 10H3 
MCI slot number = 7 
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START _NET_DELAY_MEASUREMENT (STANDM) 
NETOU Command 

Purpose Starts the network delay measurement. The start processor validates the 
input parameters, loads and starts the measurement task, and issues a 
command response indicating the start status of that task. 

Format START_NET_DELAY_MEASUREMENT 

DESTINATION .SYSTEM = name 

DELAY JTIME JTHRESHOLD = integer 0..7FFFFFFF 

AVERAGE JONLY = boolean 

MEASUREMENTS = integer L.7FFFFFFF or CONTINUOUS 

MESSAGES _PER ^MEASUREMENT = integer 1..7FFFFFFF 

MESSAGE PRIORITY = keyword 

INTER .MEASUREMENT JNTERVAL = integer 0..7FFFFFFF 

ERROR _THRESHOLD = 1. . messages _j>er _measurement 

MESSAGE JTIMEOUT = integer 1..7FFFFFFF 

Parameters DESTINATION _SYSTEM (DS) 

Specifies the system name which the network delay measurement is to be 
made from the source (originating) system. This is the name as designated 
by the SYSTEM _NAME parameter on the DEFINE _SYSTEM command. 

DELAY JTIME JTHRESHOLD (DTT) 

Specifies the delay time threshold in milliseconds. The threshold is 
compared against the calculated one-way message delay time. This 
parameter is required if AVERAGE _ONLY is NO. 

There is no default. 

AVERAGE JONLY (AO) 

Specifies a mode selection allowing the average delay time to be calculated 
and reported but no delay time threshold comparisons made. 

Default is NO. 

MEASUREMENTS (M) 

Specifies the number of times a measurement is made or repeated. A value 
of is set to a value of 1. The keyword CONTINUOUS (C) allows the 
measurement to be made until a stop command is issued. 

Default is CONTINUOUS. 

MESSAGES JPER JMEASUREMENT (MPM) 

Specifies the number of consecutive messages sent within a measurement. 

Default is 25. 

MESSAGE PRIORITY (MP) 

Specifies the priority at which messages are sent. Allowed values are: 

INTERACTIVE (I) 
BATCH (B) 
SYSTEM (S) 
REALJTIME (R) 

Default is INTERACTIVE. 
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INTER ^MEASUREMENT INTERVAL (IMI) 

Specifies the time interval in minutes between transmission of groups of 
consecutive messages. A value of causes the measurement to run until 
the measurements count is reached. 

Default is 60 (1 hour). 

ERROR ..THRESHOLD (ET) 

Specifies the number of messages exceeding the DELAY_TIME_ 
THRESHOLD in a measurement before the condition is reported. 
Default is 1. 

MESSAGE JTIMEOUT (MT) 

Specifies the amount of time, in seconds allowed for a message to be 
returned from a destination system. A value of causes the measurement 
to terminate immediately. 

Default is 120 (2 minutes). 

Responses Network Delay Measurement STARTED to < destination _system>. 

-WARNING-- "inter .measurement ..interval" is zero. 

-WARNING- "delay _time .threshold" is zero. 

-WARNING- "message .timeout" is less than "delay _time .threshold". 

-ERROR- "delay _time .threshold" not specified. 

—ERROR- "error .threshold" cannot be greater than "message .per. 
measurement". 

-ERROR- Network Delay Measurement to < destination .system > is 
already active. 

-ERROR- System < destination .system > is unknown. 

-ERROR- Destination system < destination .system > is not a CDCNET 
OSI system. 

-FATAL- Command aborted. Unable to start measurement task. 

Examples senc 'start_net_delay_measurement dest1nat1on_system=nd1_d2.. 
de 1 ay_t f me_t hresho l d=400 ' s=md1 _a 1 

FROM MDI_A1 
Network Delay Measurement STARTED to NDI_D2. 
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START_NETWORK (STAN) 
NETOU Command 

Purpose Starts communications over an X.25, Ethernet, or HDLC network solution. 
Also starts the underlying X.25, Ethernet, or HDLC trunk. For HDLC 
rotary (multiple trunk) networks, all trunks that are started are shown. 

A START_NETWORK command is the same as a START_TRUNK 
command except for HDLC rotary networks. Both START_NETWORK and 
STARTJTRUNK start the communication media. A STARTJTRUNK 
command, however, does not work for X.25 trunks; only the START_ 
NETWORK or START_X25 .INTERFACE command starts the 
communication media for X.25 trunks. The only time it makes sense to use 
STARTJTRUNK is for HDLC rotaries. With HDLC rotaries, more than one 
trunk is associated with the specified HDLC network. To start only one 
rotary trunk, use STARTJTRUNK. To start all trunks, use START_ 
NETWORK. 

Format START JNETWORK 

NETWORK _NAME = name 

Parameters NETWORK _NAME (NN) 

The logical name of the network assigned by the define command that 
configured the network solution. 

Responses < Network _type> network <name> started for trunk < trunk _name>. 

< Network _type> network <name> started for trunks (< trunk _name> 
<trunk_name>..). 

-WARNING- The 3A Command Processor has timed- out waiting for 

response from SSR. 

Please check network status for completion of request. 

-ERROR- Network <name> already started for trunk < trunk _name>. 

—ERROR— Trunk < trunk _name> down. Unable to start network 

< network _name > . 

-ERROR- Trunk < trunk _name> off. Unable to start network 

< network _name > . 

-ERROR— Network <name> is not defined. 
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-FATAL- Unable to start task < entry _point_name>. 

-FATAL- Stream Service Error. 

(This response includes one of the following error messages). 

The device manager did not accept a function for the ESCI board. 

Unable to initialize ESCI board. 

HDLC SSR received error when sending command to DVM. 

HDLC SSR received error on start port services. 

Not enough memory is currently available for required table space. 

Unable to open statisics SAP. 

Unable to open memory management SAP. 

-FATAL- Unable to start task < entry _point_name>. 

Examples start_network network_name=plymouth_net_1 

ETHERNET Network PLYM0UTH_NET_1 started for trunk 
PLYM0UTH_TRUNK_1. 
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START ..NETWORK .METRICS (STANM) 
NETOU Command 

Purpose Starts the collection and optional reporting of statistics for one or more 
network solutions. If statistics are already started for a network solution, 
they are immediately reported and the report period restarted. The 
statistics for a network solution include statistics from the stream service 
routine (SSR) supporting the network and statistics from the Intranet (3A) 
layer. The Network Performance Analyzer (NPA) reports that collect 
network statistics are ETHRRP1 and ETHRRP2 (for Ethernet network 
solutions), MCISRP1, MCISRP2, and MCISRP3 (for mainframe channel 
pseudo network solutions). 

Format START_NETWORK .METRICS 

NETWORK .NAME = list 1..15 of name 
REPORT.INTERVAL = 1..86400 

GROUP = list 1.2 of keyword value 
REPORT = boolean 

Parameters NETWORK .NAME (NN) 

The name or names of one or more network solutions or the interface 
name for a NOS/VE channel (defined by the DEFVI command). The names 
are those defined during configuration. For example, the network solution 
name for an Ethernet network solution is defined by the DEFINE. 
ETHER.NET command described in this manual. The network name for a 
NOS/VE mainframe channel interface is defined by the INTERFACE. 
NAME parameter on the DEFVI command described in this manual. 

For this CDCNET release, the network name of a NOS mainframe channel 
interface is defined during the DI load process and uses a default logical 
name. The channel trunk name is the NETWORK .NAME for the channel 
interface to a NOS host. Network and trunk names can be found by using 
the DISPLAY.LOGICAL .NAMES command described in this manual. 

REPORT.INTERVAL (RI) 

Statistic reporting interval, specified in seconds. This parameter indicates 
how often the statistics are reported. The maximum interval is 24 hours 
(86,400 seconds). 

GROUP (G) 

Level of statistics to be collected: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is SUMMARY. 

REPORT (R) 

Specifies whether or not a reporting message should be generated through 
log messages. Possible values are YES, generate reporting message, and 
NO, do not generate reporting message. Default is YES. 
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Responses The following response indicates the network metrics have been 
successfully started. 

NETWORK < network _name> < group _name> Metrics started, 
(one response for each network and group for which metrics was 
started). 

The following line is also output for a metric if the log message number 
used to report that the message is not enabled for the DI. When you 
receive this message, you may enable any messages listed using the 
CHANGE .SOURCE _LOG .GROUP command described in this manual. 

Reporting log message < message .number > not enabled. 

For networks that are not defined or do not support network metrics, the 
following lines are inserted. 

Network < network _name> not defined. 

Network < network _name> < group _name> metrics not supported. 

The following error messages may be received. 

-FATAL-- Network < network _name> metrics start-up failed. 

-FATAL- Network < network _name> metrics start-up failed, not 
enough memory currently exists for required table space. 

Remarks In order for Ethernet statistics to be reported, log message number 639 
must be enabled. To check if this message is enabled, use the DISPLAY. 
SOURCE _LOG_GROUP command described in this manual. If this 
message is not enabled, enable it using the CHANGE _SOURCE_LOG_ 
GROUP command described in this manual. 

See the NPA commands in this manual for information on creating 
statistics reports using the REFORMAT_CDCNET_LOG_FILE (REFCLF) 
and CREATE .CDCNET.ANALYSIS .REPORT (CRECAR) commands. 

Examples start_network_metrics nn=b1d_3_ethernet,M =360, g=( summary, expanded) 

Network BLD_3_ETHERNET summary metrics started. 
Network BLD_3_ETHERNET expanded metrics started. 
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START 
NETOU 

Purpose 



Format 



Parameters 



Responses 



Examples 



NP.INTERFACE (STANI) (NOS MDI Only) 
Command 

Starts the Network Products (NP) protocol over a NOS mainframe channel 
to a NOS system and starts the underlying channel trunk protocol if it has 
not already been started. 

START_NP_INTERFACE 

INTERFACE _NAME = name 

INTERFACE _NAME (IN) 

The logical name of the interface assigned by the DEFINE _NP_ 
INTERFACE command described in this manual. 

NP_interface < interface _name> started. 

-ERROR- NP interface < interface _name> is not defined. 

-ERROR- NP interface < interface _name> already started. 

-FATAL- Unable to start NP interface <interface_name>. Unable to 
start task SVM. 

-FATAL- Unable to start NP interface < interface _name>. Unable to 
start task BIP. 

-FATAL- Unable to start NP interface < interface _name>. Unable to 
send ITM to NP interface task. 

-FATAL- Unable to start NP interface < interface _name>. Memory 
management sap table not found. 

-FATAL- Not enough memory is currently available for required table 
space. 

-FATAL- Unable to start NP interface < interface _name>. Unknown 
status returned from open memory sap. 

—FATAL— NP interface < interface _name> command processor has 
timed- out waiting for a response from the NP interface task that 
initialization is complete. 

st art_np_ Inter face 1n=cyber_109 
NP Interface CYBER_109 started. 
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START.OUTCALL .GATEWAY (STAOG) 
NETOU Command 

Purpose Starts the Outcall Gateway. 

Format START _OUTC ALL .GATEWAY 

Parameters None. 

Responses Outcall Gateway is started. 

-WARNING- Outcall Gateway is already started. 

-ERROR- Outcall Gateway is not defined. 
Examples start _out ca 1 1 _gat eway 

Outcall Gateway 1s started. 
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START_PASSTHROUGH ^SERVICE (STAPS) 
NETOU Command 

Purpose Starts the interactive passthrough service. The service allows passthrough 
ports to connect to the Interactive Passthrough Gateway and register their 
respective titles. 

NOTE 



In future releases, this command will no longer be supported. You should 
start using the START_OUTCALL .GATEWAY command as soon as 
possible. 



Format START_PASSTHROUGH ..SERVICE 

Parameters None. 

Responses Passthrough Service started. 

-ERROR- Passthrough Service not defined or already started. 
Examples start _passt hrough_serv1 ce 

Passthrough Service started. 
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START .PORTJTEST (STAPT) 
NETOU Command 

Purpose Starts an online diagnostics test on an individual LIM port. 

This diagnostic test should be run if failures are reported on only one port 
or on lines associated with multiple LIMs. Multiple port tests should be 
run at the same time if failures are reported on lines associated with 
multiple LIMs. 

NOTE 

Do not run diagnostics on a port configured with a trunk or line speed of 
56 Kbs, that is attached to a CIM which is also supporting other activity. 
The port diagnostics fail. 

Format START_PORT_TEST 

DEVICE _NAME = name 

REPEAT JPASS = integer 0..65535 
SUCCESS _STATE = keyword value 
LOGGING = boolean 
STOP_ON_ERROR = boolean 
LOOP_MODE = keyword value 
MODEM JCLASS = integer 1..6 

Parameters DEVICE _NAME (DN) 

Physical name of the device to be tested, consisting of a dollar sign ($), 
board type (LIM), its slot number, the keyword PORT, and port number. 
For example, $LIM3 JPORT1 is the device name for port 1 on the LIM 
board in slot 3. 

REPEAT JPASS (RP) 

Specifies how many times you want the test to repeat. The value 
specifies that the test is run indefinitely until you stop the test by a 
STOP_PORT_TEST command described in this manual. Default is 1. 

NOTE 

If the STOP_ON_ERROR parameter is set to OFF, an error causes the 
test to terminate the current pass and restart testing at the beginning of 
the next pass. 

SUCCESS _STATE (SS) 

Determines the state in which the hardware device is left upon successful 
completion of the diagnostic test. Possible values are ON and DOWN. ON 
specifies that the device state is set to ON if the test completes without 
error, but remains set to the DOWN state if the test detects an error. 
DOWN specifies that the state remains set to DOWN regardless of the test 
outcome. Default is ON. 

LOGGING (L) 

Specifies whether you want the diagnostic messages logged in a log file. 
There are two possible values for this parameter: ON and OFF. ON 
specifies that diagnostic messages are logged in the log file. OFF specifies 
that diagnostic messages are not logged. Default is ON. 
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STOP_ON_ERROR (SOE) 

Specifies whether or not you want the test to end if an error condition is 
encountered. There are two possible values for this parameter: ON and 
OFF. ON specifies that the test is stopped if any error occurs. OFF 
specifies that the test is not stopped if any error occurs. See note with the 
REPEAT_PASS parameter. Default is ON. 

LOOPJdODE (LM) 

Selects method of loopback for the LIM port. The following three keyword 
values, and corresponding loopback modes are allowed. 



Keyword Description 



INTERNAL (D Checks the internal logic of the LIM port by sending 

a signal through it, but not through the board's 
drivers or receivers. Does not check anything past the 
LIM port. 

EXTERNAL (E) Checks transmitters and receivers on the LIM port. 
This loopback mode requires a loopback plug jumper 
to be placed on the LIM port before running the 
loopback test. 

MODEM (M) Checks the LIM port including external cables, the 

modem or modems, and the communication line. The 
modem (local or remote) must be manually switched to 
loopback data towards the LIM. See the specific 
modem user manual to determine the proper switch 
setting. To run the modem loopback test, specify 
MODEM when entering the START_PORT_TEST 
command and select the loopback on the local or 
remote modem before starting the test. 

The use of the external clock is a strap selectable 
feature on the RS-449 Model A LIM. The strap must 
be removed to run the external loopback test. 

Port Strap Location Pins 

63G3 9-12 

1 44K6 4-17 



60000414 C START Commands 12-27 



START _PORT_TEST (STAPT) 



Keyword Description 



The MODEM loopback test can also be used to check 
the LIM port to terminal connections when modems 
are not present. This can be done by using a loopback 
plug at any point in the LIM port to terminal path. 
The modem loopback test raises RTS and DTR and 
checks for CTS and DCD to be active and for TxD to 
be tied to RxD. RS-232-C and RS-449 loopback plugs 
are included in the Customer Maintenance Kit. See 
the CDCNET Hardware Installation and 
Troubleshooting Guide for the correct loopback plug 
part number. To run the modem loopback test on this 
type of configuration, specify MODEM when entering 
the START_PORT_TEST command and ensure that 
the correct loopback plug is installed. Also, if the LIM 
port has not yet been configured as an ASYNC line, 
the MODEM _CLASS parameter must be specified 
with a value of 2, 4, or 6 (see MODEM _CLASS 
parameter description). 

The following table shows the functional loopback 
required to run the modem loopback test. 



Signal Name 


RS-232 


CCITT 


RS-449 


Transmit Data 
(TxD) 


BA 


103 


SD 


Receive Data 
(RxD) 


BB 


104 


RD 


Request to Send 
(RTS) 


CA 


105 


RS 


Clear to Send 

(CTS) 


CB 


106 


CS 


Data Terminal 
Ready (DTR) 


CD 


108/2 


TR 


Data Carrier 
Detect (DCD) 


CF 


109 


RR 



Default is INTERNAL. 

Both EXTERNAL and MODEM loopback first executes INTERNAL 
loopback testing. Also, EXTERNAL and MODEM loopback methods may 
only be selected for LIM port testing, not for other board tests. Run the 
INTERNAL and EXTERNAL options before running the MODEM option. 
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MODEM JCLASS (MC) 

Selects the maximum modem speed for a group of MODEM types. This 
parameter is only used when LOOP_MODE= MODEM is selected, and it is 
required if you choose MODEM loopback, and if the port has not been 
configured or has been configured as a line with autorecognition. The 
following modem class table provides information about modem classes and 
speeds. There is no default value for this parameter. See the CDCNET 
Hardware Installation and Troubleshooting Guide for more information on 
loopback testing for modems. 



Modem 
Type 


Operating 
Mode 


Maximum 
Speed (bps) 


Modem 
Class 


Bell 201C 


Sync 


2,400 


1 


Bell 103 


Async 


300 


2 


Bell 113 


Async 


300 


2 


Bell 212A 


Sync 


1,200 


3 


Bell 212A 


Async 


1,200 


4 


Avanti 2200 


Sync 


56,000 


5 


Gandalf LDS260 


Sync 


56,000 


5 


Avanti 2200 


Async 


19,200 


6 
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Responses The following response is received if the test starts successfully. 

PORT test started, version < version ..number >. 
CIM Slot number = <cim slot number >. 
LIM Slot number = <lim slot number >. 
PORT number = <port number >. 

You receive the following response if the test has already been started. 

-WARNING— Device < device _name> test already started. 
The following error messages may be received. 

-ERROR- Device < device __name> not installed in system. 

-ERROR- Device < device _name> not in "DOWN" state. 

-ERROR- Device <device_name> cannot be tested at this time. 
$CIM<cim slot number > must be dedicated to the < driver _type> 
driver and is currently active. The STAPT command may be reissued 
once all active lines/trunks on $CIM<cim slot number > are stopped. 

-FATAL- PORT test aborted, version < version .number >. 
CIM slot number = <cim slot number >. 
LIM slot number = <lim slot number >. 
PORT number = <port number >. 
< abort reason - See below* >. 

You receive the following response if the test task could not start. 

Unable to start test task 

You receive the following response if the LIM is none of the listed 
supported types. 

4-channel RS232 (xx=08 (16) through OF (16)) 
RS449 (xx=O0 (16) through 07 (16)) 
V.35 (xx=20 (16) through 27 (16)) 

Test not allowed for LIM type xx. 

You receive the following response when you try a port test on an RS-232 
LIM with an invalid ID type. Only LIM testing is allowed. The port test is 
allowed on RS-232 LIMs with an ID type of 09 through OE (16). 

Port test is not allowed for LIM type xx 
ENTER "start_lim_test dn=$limx" 

You receive the following response when the test task starts but 
terminates prematurely. 

Test task stop flag set. 
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You receive the following response after an attempt was made to run the 
modem loopback test without indicating the modem class. The modem class 
parameter is required if the line has not been configured or has been 
configured as an autorecognition line. Include the modem class parameter 
or reconfigure the line and reenter the START command to run the test. 

Modem class (MC) parameter is required for modem loopback when line 
has not been configured or is an auto-rec line. 

There is a special case defined for CIM and LIM failures that prohibits 
starting a lower level test such as a port test. That is, if the CIM or LIM 
has failed, you cannot start a port test until you run a CIM or LIM test 
(using the START_CIM_TEST or START_LIM_TEST commands). In such 
a case, if you enter a START_LIM_TEST command,an abort response is 
issued with a reminder to run the higher level test, as in the following 
example. 

-FATAL- PORT test aborted, version 0901 

CIM slot number = 6 

LIM slot number = 3 

Port number = 2 

Previous LIM failure requires LIM to be tested first 

Enter "START_LIM_TEST DN=$LIM3" 

Remarks In order for the port test to run, the device state must be DOWN. Use the 
CHANGE _ELEMENT_STATE (CHAES) command described in this manual 
to change the state of the device. 

To get the results of the port test, send the DISPLAY_TEST_STATUS 
command described in this manual, to the DI that contains the device 
being tested. 

If you specify SUCCESS _STATE = DOWN, you must use the CHANGE. 
ELEMENT_STATE command when the diagnostic completes to put the 
device in the ON state. 

Examples start_port_test dev1ce_name=$Hm3_port1 

PORT TEST STARTED, VERSION 10H3. 
CIM slot number = 5. 
LIM Slot number = 3. 
Port number ■ 1. 
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START_PROCESS 
NETOU Command 



.METRICS (STAPM) 



Purpose Starts the collection and optional reporting of statistics for the specified 

software processes and statistic groups. If statistics are already started for 
the software processes specified, they are immediately reported and the 
report period restarted. Software statistics are reported in the following 
Network Performance Analyzer (NPA) reports: DIOSRP1, DIOSRP2, 
DIOSRP3, and DIOSRP4 (for DI operating system statistics), and SESSRP1 
(for Session layer statistics). 

Format START_PROCESS .METRICS 

PROCESS = list 1..15 of name 
REPORT.INTERVAL = 1..86400 
GROUP = list 1..3 of keyword value 
REPORT = boolean 

Parameters PROCESS (P) 

Logical name of a communications system process. The following table lists 
the supported software processes that can be used as keywords. A note in 
parentheses is a brief description of the information tracked. The table also 
provides the log/alarm number associated with each process. 





Log/Alarm 


Software Process 


Message 


command 


405 


directory 


95 


dod_internet 


1357 


independent _log_me (source log) 


446 


intranet (summary) 


889 


intranet (expanded) 


890 


log_support_application (source log) 


424 


osa (Operator Support Application) 


547 


session 


737 


system 


299 


tcp (Transmission Control Protocol) 


1453 


egp(tcp/ip external gateway protocol) 


1435 


clns 


1648 


es_is_routing 


1873 


channel .connection 


1693 


udp (tcp/ip user datagram protocol) 


1700 


transport (summary) 


1628 


transport (expanded) 


1629 


np_ivt_gw 


746 


is _is .routing 


1913 


cons 


1924 


llc_2 


105 
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REPORT _INTERVAL (RI) 

Statistic reporting interval, specified in seconds. This parameter indicates 
how often the statistics are reported. The maximum interval is 24 hours 
(86,400 seconds). 

GROUP (G) 

Type of statistics group requested. Possible keyword values include the 
following: 

SUMMARY (S) 
EXPANDED (E) 
DEBUG (D) 
ALL (A) 

Default is SUMMARY. 

REPORT (R) 

Specifies whether or not a reporting message should be generated via a log 
message. Possible values are YES, generate reporting message, and NO, do 
not generate reporting message. Default is YES. 

Responses You receive the following response if the process metrics successfully 
started. 

< process _name> < group _name> metrics started. 

The following line is also output for a metric if the log message number 
used to report that metric is not enabled for the DI. When you receive this 
message, you may enable any messages listed using the CHANGE _ 
SOURCE _LOG_GROUP command described in this manual. 

Reporting log message < message _number> not enabled. 

For processes that are not defined or do not support process metrics, the 
following lines are inserted: 

< process > unknown. 

< process _name> < group _name> metrics not supported. 
Specified group not suppported for this process. 

-FATAL- < process _name> metrics failed. 

-FATAL— < process _name> metrics startup failed, not enough 
memory currently exists for required table space. 
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Remarks To check if these log messages are enabled, use the DISPLAY_SOURCE_ 
LOG_GROUP command described in this manual. If these log messages 
are not enabled, enable them using the CHANGE _SOURCE_LOG_ 
GROUP command described in this manual. 

See the NPA commands in this manual for information on creating 
statistics reports using the REFORMAT_CDCNET_LOG_FILE (REFCLF) 
and CREATE _CDCNET_ANALYSIS .REPORT (CRECAR) commands. 

Examples star t _process_met r 1 cs p-sessl on , r 1 =>360 , g= ( summary , expanded ) 



SESSION summary metrics started 
SESSION expanded metrics started 
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NETOU 

Purpose 



Format 



START_SERVER_TELNET_GW (STASTG) 



SERVER _TELNET_GW (STASTG) 
Command 

Starts the host terminal gateway service. The gateway accepts TELNET 
connections from remote users and connects these users to the defined host 
interactive terminal service. 



START_SERVER _TELNET_GW 
GATEWAY_NAME = name 



Parameters GATEWAY_NAME (GN) 

The logical name of the server TELNET host gateway defined by a 
DEFINE .SERVER _TELNET_GW command described in this manual. 

Responses Server TELNET gateway < gateway _name> is started. 

-ERROR- Server TELNET gateway < gateway _name> is not defined. 

-ERROR- Server TELNET gateway < gateway _name> is already started. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples start_server_telnet_gw gateway_name=gw_to_cyber 
Server TELNET gateway GW_TO_CYBER is started. 
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START_SLIP_GW (STASG) 
NETOU Command 

Purpose Starts the SLIP gateway service. The titles from the DEFINE SLIP_GW 
command are registered so that CDCNET can establish SLIP networks to 
CDCNET. 

Format START_SLIP_GW 

GATEWAYlNAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the SLIP gateway as previously defined in a 
DEFINE _SLIP_GW command. This parameter is required. 

Responses SLIP gateway < gateway _name> is started. 

-ERROR- SLIP gateway < gateway _name> is not defined. 

-ERROR- SLIP gateway title < title > is already defined. 

-WARNING- SLIP gateway < gateway _name> is already started. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples start_sl i p_gw gateway_name=sl 1 p_gw 
SLIP gateway SLIP.GW Is started. 
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START J3UBNET_CONNECT_TEST (STASCT) 
NETOU Command 

Purpose Starts the inline diagnostic test between a directly connected source and 
destination system. 

Format START_SUBNET_CONNECT_TEST 

DESTINATION .SYSTEM = name 

SUBNET JNAME = name 
MESSAGE JLENGTH = keyword 
MESSAGE JCOUNT = 1..60 
MESSAGE INTERVAL = 0..1000 
REPEAT_PASS = integer 0..65535 
LOGGING = boolean 
STOPjONJERROR = boolean 

Parameters DESTINATION .SYSTEM (DS) 

Specifies the system name to which the CLNS PDU is sent. The system 
name is designated by the DEFINE _SYSTEM command (described in this 
manual). 

SUBNET JSTAME (SN) 

Specifies the subnet name used to reach the destination system. This name 
is designated by the DEFINE _xxx_NET commands (described in this 
manual). When the subnet name is not specified, the routing software 
determines the subnet used to reach the destination system. 

MESSAGE LENGTH (ML) 

Specifies a random or fixed range of length for each message which is 
transmitted in the test. If a random value is selected, the length of the 
messages varies within the selected range as determined by the test. The 
value of the fixed range is from 1 to 512. 

The following range value keywords maybe used: 



Keyword 



Range (bytes) 



MAX Maximum size per subnet 

SMALL (S) 1 to 256 

LARGE (L) 256 to MAX 

MDXED (M) 1 to MAX 

Default is MIXED. 

MESSAGE JCOUNT (MC) 

Specifies the number of messages sent in each pass of the test. The values 
are from 1 to 60. Default is 1. 

MESSAGE INTERVAL (MI) 

Specifies the time interval in milliseconds between transmissions of the 
messages. Zero indicates immediate transmission. The maximum time 
allowed between transmissions is 1 second (1000 milliseconds). Default is 
millisecond. 
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REPEAT_PASS (RP) 

Specifies the number of times the test is repeated. If is used, the test 
runs continuously until stopped by the operator. Default is 1. 

LOGGING (L) 

Specifies whether log messages are issued (ON) or not (OFF). Default is 
ON. 

STOP JON JERROR (SOE) 

Specifies whether the test stops when an error is detected (ON) or if it 
continues running (OFF) until the pass counter is reached or an operator 
stops the test. Default is ON. 

Remarks The source system is always the system to which the SENC command is 
issued and in which the STASCT is executing. 

Responses Subnet Connect Test STARTED. 

Destination System = < destination _system> 
Subnet = < subnet _name> 

-INFORMATIVE- Subnet < subnet _name> is not available for testing. 

-ERROR- Subnet Connect Test of < subnet _name> is already running. 

-ERROR— Subnet < subnet _name> is congested, the test may not be 
started. 

—ERROR— System < destination _system> is unknown. 

-ERROR- < system _type> system < system _name> is NOT a CDCNET 
OSI system. 

-ERROR— Subnet < subnet _name> is not directly connected. 

-ERROR— System < destination __system> is not directly connected via 
subnet < subnet _name>. The Subnet Connect Test only allows directly 
connected systems to be tested. 

-ERROR- System < destination _system> is not directly connected. The 
Subnet Connect Test only allows directly connected systems to be tested. 

-ERROR- Unable to start test task. 

-ERROR- NIL pointer for status record in the NIB. 

-ERROR- No test task response before a timeout. 
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CYBER 
A 



SO 



ICA 



MDI A1 



ICA1 



TDIC1 



TDI C2 



NDI D1 



■• SUBNETJ 



NDI D2 



TDIE1 



TDI E2 



V SUBNET2 



TDIE3 



M04271 



Figure 12-1. Catenet Example 

Examples Figure 12-1 shows a hypothetical catenet consisting of two subnets 

connected by two NDIs. The connection from CYBER A through MDI_A1 
to both Subnet _1 and Subnet _2 illustrates dual paths from a system. In 
the following examples, references are made to this catenet. 

senc c='start_subnet_connect_test dest1nation_system=nd1_d2' s=md1_a1 

FROM MDI_A1 

Subnet Connect Test STARTED. 
Destination System = NDI_D2 
Subnet = SUBNET_2 

In this example, there are two possible paths to the destination system. 
Since no subnet was specified in the command, the response indicates the 
subnet used to reach system NDI_D2. 

senc c*'stasct ds=ndi_d1 sn=subnet_l rp=0' s=md1_a1 

FROM MDI_A1 

Subnet Connect Test STARTED. 
Destination System = NDI_D1 
Subnet = SUBNET_1 

In this example, a subnet _name is specified, so the test must test between 
the two directly connected DIs on SUBNET_1. 
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START. 
NETOU 

Purpose 



Format 



Parameters 



Responses 



Examples 



,TCPIP_GW (STATG) 
Command 

Starts the TCP/IP application interface gateway. The gateway registers 
titles specified from the DEFINE _TCPIP_GW command described in this 
manual to allow host-resident applications to make TCP/IP connections. 

START_TCPIP_GW 

GATEWAY.NAME = name 

GATEWAY_NAME (GN) 

The logical name of the TCP/IP application gateway defined by a 
DEFINE _TCPIP_GW command described in this manual. 

TCP/IP Gateway < gateway _name> is started to support <protocol> 
protocol. 

-ERROR- TCP/IP gateway < gateway _name> is not defined. 

-ERROR- TCP/IP gateway < gateway _name> is already defined. 

-ERROR— TCP/IP gateway < gateway _name> is already started. 

-FATAL- TCP/IP gateway < gateway _name> was unable to open SAP. 

start.tcpi p_gw gateway_name=f tp_gw 

TCP/IP gateway FTP_GW is started to support TCP protocol. 
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STARTJTRACE .PROCESS (STATP) 

Purpose Starts the collection of trace information for the given process. 

Format STARTJTRACE .PROCESS 

PROCESS = name 

ARRAY JSIZE = integer 1 .. 65535 
DATA JSIZE = integer 1 .. 65535 
FILTER = list 1 ..4 of any 

Parameters PROCESS (P) 

Specifies the name of the process. The following processes and information 



can be traced: 
Process 



Description 



CHANNEL_CONNECTION 
DFA (Dependent File Access) 
DIRECTORY 
DOD_INTERNET 
ES_IS .ROUTING 

HDLC 

LLC_2 

RIP (Routing Information 
Protocol) 

SYSTEM 

TRANSPORT 



Protocol Data Units 

Intertask messages 

Protocol Data Units and database updates 

Protocol Data Units 

Protocol Data Units and miscellaneous 
events 

Protocol Data Units and intertask messages 

Protocol Data Units 

Protocol Data Units and events 

Task snapshot at 100-millisecond intervals 
Protocol Data Units 



X25_PL (X.25 Packet Level) Protocol Data Units 
ARRAY JSIZE (AS) 

Specifies the size of the array where the trace information is kept. For 
example, if ARRAY_SIZE is 10, only the last 10 trace information entries 
are kept before reusing the entries. The bigger the ARRAY_SIZE value, 
the more memory is used. Only in rare instances should this parameter be 
set larger than 100. If possible, depending on problem being analyzed, the 
operator should stop the traced process after the needed trace is captured 
to avoid memory problems. The default is 100. 

DATA JSIZE (DS) 

Specifies the amount of variable data to keep. An odd number is rounded 
to the next even number. The bigger the DATA_SIZE value, the more 
memory is used. Only in rare instances should this parameter be set larger 
than 32. If possible, depending on problem being analyzed, the operator 
should stop the traced process after the needed trace is captured to avoid 
memory problems. The default is 32. 
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FILTER (F) 

Specifies a filter to be used in tracing. Only what is stated in the filter is 
traced. The value you specify is process- dependent: 

Process Allowed Filter Value 



CHANNEL _ SAP name, based on a CC SAP opened in the DI (to 

CONNECTION determine available names, use command DISPLAY 

CHANNEL _CONNECT_STATUS). 

DFA File name as a string (can include wild cards). The 

trace does not include ITMs (Intertask Messages) 
associated with other file names. 

DIRECTORY Title name (or subset of a title name). This is not a 

precise filter, since it involves matching an ASCII 
string within a Protocol Data Unit (PDU) for the PDU 
events. For the internal data structure events, a 
subset of the title matches only when the subset is at 
the beginning of the title. 

DOD_INTERNET IP address (list of 4 octets). The trace includes each 
IP datagram with a matching source or destination IP 
address. 

ES_IS_ROUTING Peer MAC address string (may include wild cards). 

The trace includes only data that is to be sent to the 
peer MAC address for transmitted data. It includes 
the miscellaneous items. 

NOTE 



The string filter has a maximum size of 32. If a value 
greater than 32 is given, the trace uses only the first 
32 characters. 



TRANSPORT SAP name as a string (can include wild cards), based 

on a SAP opened in the DI (to determine available 
names, use command DISPLAY_OSI_TRANSPORT_ 
STATUS). Use the SAP name for any Transport user, 
for example, to trace RBF GW traffic for a potential 
printer problem. You can also supply a local reference 
ID. The trace includes only Transport Protocol Data 
Units (TPDUs) associated with the specified reference 
ID. 
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X25_PL 



All others 



Either a trunk name, as defined by DEFINE _X25_ 
TRUNK, DEFINE _HDLC_TRUNK, or DEFINE. 
LLC_2_TRUNK, or a peer DTE address string (can 
include wild cards). If you use a trunk name, the 
trace includes only data associated with the specified 
trunk name. If you use a peer DTE address string, 
the trace includes only packets associated with the 
logical channel numbers associated with the specified 
peer DTE address. 

The parameter is ignored. 



NOTE 



The default is no filtering. There is limited error checking on filters, both 
for syntax and semantics. The filters that use wild cards are case-sensitive; 
for example, DFA opens a Transport SAP with the name Dep. File Access', 
so a filter of '*ep.*' matches it, but a filter of 'DEP*' does not match. 



Responses TRACE started for process <name>. 

-ERROR— TRACE entry point not found for process <name>. 

-ERROR— TRACE already started for process <name>. 

-FATAL— Not enough memory currently exists for required table space. 
Examples start_trace_process process=transport f tlter='Dep*' 

TRACE started for process TRANSPORT. 
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START JTRUNK (STAT) 
NETOU Command 

Purpose Starts communications over an HDLC or Ethernet trunk. This command is 
the same as START_NETWORK, except for HDLC rotary (multiple-trunk) 
networks. The START_NETWORK command starts all the HDLC trunks 
defined for the HDLC network. The START_TRUNK command starts only 
the given HDLC trunk. Use the START_NETWORK command except for 
rotary HDLC networks and when you want to start specific trunks. 

For an X.25 trunk, either DEFINE _X25 .INTERFACE START = YES or 
START_X25_INTERFACE starts the X.25 interface and the underlying 
media. For this reason, STARTJTRUNK does not work with a defined X.25 
trunk. The error returned when you try to use START_TRUNK with an 
X.25 trunk is: 

ERROR- Unknown trunk type. 

Format START_TRUNK 

TRUNK _NAME = name 

Parameters TRUNK _NAME (TN) 

Specifies the logical name of the trunk assigned by the DEFINE command 
that configured the trunk. 

Responses Trunk <name> started. 

-ERROR- Trunk <name> already started. 

-WARNING- The 3A Command Processor has timed out waiting for 
response from SSR. 

Please check network status for completion of request. 

-ERROR- Trunk <name> is not defined. 

-ERROR- A network must be defined for trunk <name> before it can be 
started. 

-ERROR- Unknown trunk type. 

-ERROR- Network <name> already started for trunk < trunk _name>. 

-ERROR- Trunk <trunk_name> down. 

Unable to start network < network _name>. 

-ERROR- Trunk <trunk_name> off. Unable to start network 
< network .name > . 

-ERROR- Network <name> is not defined. 

-FATAL- Unable to start task < entry _point_name>. 
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STABT.TRUNK <STAT) 

-FATAL- Stream Service Error. {This response includes one of the 
following error messages.} 

The device manager did not accept a function for the ESCI board. 
Unable to initialize ESCI board. 

HDLC SSR received error when sending command to DVM. 
HDLC SSR received error on start port services. 
Not enough memory is currently available for required table space. 
Unable to open statistics SAP. 
Unable to open memory management SAP. 
Examples start_trunk trunk.name ■ menlo_park_trunk_1 
Trunk MENL0_PARK_TRUNK_1 started. 
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START JTRUNKJVIETRICS (STATM) 
NETOU Command 

Purpose Starts the collection, and optional reporting of statistics for one or more 
trunks. 

If statistics are already enabled for the specified trunk, the statistics are 
immediately reported and the report period restarted for the selected items. 
The trunk statistics include statistics from the Stream Service Routine 
supporting the trunk. These statistics are available from the NPA reports 
and the DISPLAY_TRUNK ..METRICS command described in this manual. 

Format STARTJTRUNK .METRICS 

TRUNK _NAME = list L.15 of name 
REPORT_INTERVAL = 1..86400 

GROUP = list 1..2 of keyword value 
REPORT = boolean 

Parameters TRUNK _NAME (TN) 

The logical names of one or more trunks for which statistics are to be 
collected. 

REPORT_INTERVAL (RI) 

The statistic reporting interval in seconds. The maximum interval is 24 
hours (86,400 seconds). 

GROUP (G) 

Specifies the level of statistics to be collected. The following keyword 
values are allowed: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is SUMMARY. 

REPORT (R) 

Specifies whether the statistics should be reported via log messages. 
Default is YES. 
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START_TRUNK_METRICS (STATM) 

Responses The following response occurs for each trunk metric successfully started. 

Trunk < trunk _name> < group > metrics are started 

The following response appears if the log message to report the metric was 
not enabled. 

Reporting log message < message number > not enabled. 

The following lines are output for trunks that are not defined and started 
or do not support the metric. 

Trunk < trunk _name> < group > metrics are not supported. 

The following error responses may occur. 

-ERROR- A network or interface is not defined and started for trunk 
< trunk _name > . 

—FATAL— Trunk < trunk _name> metrics startup failed. 

-FATAL- Trunk < trunk _name> metrics startup failed, not enough 
memory currently exists for required table space. 

Remarks In order for trunk statistics to be reported, one of the following log 

message numbers must be enabled: for Ethernet statistics, message number 
639, and for MCI (channel) statistics, message number 562. To check if 
either message is enabled, use the DISPLAY_SOURCE_LOG_GROUP 
command described in this manual. To enable either message, use the 
CHANGE .SOURCE _LOG_GROUP command described in this manual. 

See the NPA commands in this manual for information on creating 
statistics reports using the REFORMAT_CDCNET_LOG_FILE (REFCLF) 
and CREATE _CDCNET_ANALYSIS .REPORT (CRECAR) commands. 

Examples start_trunk_metr1cs tn= bld_3_trunk,r1=360,g=(summary, expanded) 

Trunk BLD_3_TRUNK summary metrics started 
Trunk BLD_3_TRUNK expanded metrics started 
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START JJDP_INTERFACE (STAUI) 
NETOU Command 

Purpose Starts the User Datagram Protocol (UDP) interface layer. UDP must have 
been previously defined by the DEFINE _UDP_INTERFACE command 
described in this manual. 

Format START _UDP_INTERFACE 

Responses UDP Interface is started. 

-ERROR- UDP interface is not defined. 

-ERROR- UDP interface is already started. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples start_udp_1nterface 

UDP interface Is started. 
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START _URI_TEST (STAUT) 
NETOU Command 

Purpose Starts the online diagnostics test on an individual unit record interface 
(URI). 

Format STARTJURI _TEST 

DEVICE _NAME = name 

REPEAT JPASS = integer 0..65535 
SUCCESS JSTATE = keyword value 
LOGGING = boolean 
STOP JON _ERROR = boolean 
LOOP .MODE = keyword value 

Parameters DEVICE .NAME (DN) 

Physical name of the device to be tested, consisting of a dollar sign ($), 
board type (URI), and its slot number. 

REPEAT JPASS (RP) 

Specifies how many times you want the test to repeat. The parameter 
value specifies that the test is run indefinitely until you stop the test by 
a STOP_URI_TEST command described in this manual. Default is 1. 

NOTE 



If the STOP_ON_ERROR parameter is set to OFF, an error causes the 
test to terminate the current pass and restart testing at the beginning of 
the next pass. 



SUCCESS JSTATE (SS) 

Determines the state in which the hardware device is left upon successful 
completion of the diagnostic test. Possible values are ON and DOWN. ON 
specifies that the device state is set to ON if the test completes without 
error, but remains set to the DOWN state if the test detects an error. 
DOWN specifies that the state remains set to DOWN regardless of the test 
outcome. Default is ON. 

LOGGING (L) 

Specifies whether you want the messages logged in a log file. This 
parameter has two possible values: ON and OFF. ON specifies that 
messages are logged in the log file. OFF specifies that messages are not 
logged. Default is ON. 

STOPjON _PRROR (SOE) 

Specifies whether you want the test to end if an error condition is 
encountered. This parameter has two possible values: ON and OFF. ON 
specifies that the test is stopped if any error occurs. OFF specifies that the 
test is not stopped if any error occurs. See note with the REPEAT_PASS 
parameter. Default is ON. 

LOOPjdODE (LM) 

Selects method of loopback for the URI. The following keyword values are 
allowed. 
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Keyword 



Description 



EXTERNAL (E) 



INTERNAL (I) 



External loopback executes internal loopback testing 
before executing external loopback testing. Install the 
appropriate loopback plug on the URI board or the 
printer end of the URI/Printer cable before executing 
the external loopback tests. See the CDCNET 
Hardware Installation and Troubleshooting Guide for 
the correct loopback plug part number. 

Internal loopback executes internal loopback testing of 
the logic of the URI board. 



Default is INTERNAL. 

Responses The following response is returned if the test starts successfully. 

URI test started, version < version number > 
CIM slot number = <cim slot number > 
URI slot number = <uri slot number > 

The following response occurs if the test is already started. 

-WARNING- Device < device _name> test already started. 

The following response indicates that the requested device cannot be tested 
because the CIM supporting the URI to be tested is already dedicated to 
the HDLC256 or HDLC3x64 driver and the URI to be tested is configured 
to use another driver. 

-ERROR- Device <device_name> cannot be tested at this time. 
$CIM <cim slot number> must be dedicated to the <driver_type> 
and is currently active. The STAUT command may be reissued once all 
active lines/trunks on $CIM <cim slot number > are stopped. 

The following response indicates the test never started. 

-FATAL- URI test aborted, version < version _number> 
CIM slot number = <cim slot number > 
URI slot number = <uri slot number > 
Unable to start test task 

-ERROR- Device < device _name> not installed in system. 

-ERROR- Device <device_name> not in "DOWN" state. 

-ERROR- Device < device _name> addresses a port that cannot be 

serviced. 

More than 48 ports are attached to CIM <cim_slot_number>. 

Ports beyond the 48th port attached to a CIM are not serviced. 
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START_URI_TEST (STAUT) 



The following response indicates the test task started but terminated 
prematurely. 

-FATAL- URI test aborted, version < version _number> 
CIM slot number = <cim slot number > 
URI slot number = <uri slot number > 
Test task stop flag set 

The following response identifies a CIM failure that does not allow you to 
start a lower level test such as a URI test. When a CIM fails, you cannot 
start a URI test until you run a CIM test (using the START_CIM_TEST 
command). When you receive the response, run the START_CIM_TEST 
command before attempting to run the START_URI_TEST again. 

—FATAL- URI test aborted, version < version number > 

CIM slot number = <cim slot number > 

URI slot number = <uri slot number > 

Previous CIM failure requires CIM to be tested first 

ENTER "start _cim_test dn= < device _name> 

Examples start_ur1_test device_name = $ur15 

URI test started, version 2301 
CIM slot number-* 6 
URI slot number= 5 
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START_USER_TELNET_GW (STAUTG) 
NETOU Command 

Purpose Starts the user TELNET interactive terminal gateway service. Gateway 

titles are selected with the TITLE (T) parameter of the DEFINE _USER_ 
TELNET_GW command described in this manual. The gateway title or 
titles are registered so that CDCNET terminal users can establish 
TELNET interactive terminal connections with a remote host. 

Format START.USER _TELNET_GW 

GATEWAYJSAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the user TELNET gateway defined by a DEFINE _ 
USER_TELNET_GW command described in this manual. 

Responses User TELNET gateway < gateway _name> is started. 

-ERROR- User TELNET gateway < gateway _name> is not defined. 

-ERROR- User TELNET gateway < gateway _name> is already started. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples start_user_te1net_gw gateway_name=vax_gw 
User TELNET gateway VAX.GW 1s started. 
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S1ARTJC25_ J ASYNCTIP (STAXA) 



START. 
NETOU 

Purpose 



Format 



X25 .ASYNCTIP (STAXA) 
Command 

Starts the X.25 asynchronous TIP service for the specified X.25 trunks. 
Allows the X.25 asynchronous TIP to accept terminal connections from the 
specified trunks. The X.25 trunk must have been previously started. 

START_X25 _ASYNCTIP 

TRUNK _NAME = list 1..32 of name 



Parameters TRUNK .NAME (TN) 

The logical name of one or more X.25 trunks for which X.25 asynchronous 
TIP service is to start. Parameter has no default. 

Responses X.25 AsyncTip support started for specified trunks. 

-ERROR- X.25 AsyncTip support not defined for trunk < trunk _name>. 

-ERROR- X.25 AsyncTip support already started on trunk < trunk _ 
name>. 

—ERROR- Duplicate trunk name < trunk _name> specified. 

Examples Start_x25_asynct1p trunk_name = telenet_2 

X.25 AsyncTip support started for specified trunks. 
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START_X25_GW (STAXG) 
NETOU Command 

Purpose Starts the specified X.25 gateway and adds title(s) registered for the 

gateway to the CDCNET directory. START_X25_GW activates any title or 
titles added with the ADD_X25 _GW_OUTCALL command described in 
this manual, and reactivates any title or titles previously inactivated 
(deregistered) when the gateway was stopped. Although the titles were 
inactivated, they remain known to the gateway. The titles are reactivated 
when the gateway is restarted. 

Format START_X25_GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of an X.25 gateway defined by a DEFINE _X25_GW 
command described in this manual. 

Responses X.25 gateway <name> is started. 

-ERROR- X.25 gateway <name> is already started. 

-ERROR- X.25 gateway < gateway _name> is not defined. 
Examples start_x25_gw gn=telenet_gw 

X.25 gateway TELENET.GW Is started. 
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START.X25 ^INTERFACE (STAXI) 
NETOU Command 

Purpose Starts the specified X.25 Packet Level interface. The START_X25_ 

INTERFACE command starts the X.25 packet level protocol on the X.25 
trunk supported by the interface, and also starts the underlying X.25 
trunk. 

Format START_X25_INTERFACE 

INTERFACE _NAME = name 

Parameters INTERFACE _NAME (IN) 

The logical name of an X.25 packet level interface defined by a DEFINE. 
X25 JNTERFACE command described in this manual. 

Responses X.25 interface <name> started on trunk < trunk _name>. 

-ERROR- X.25 interface <name> already started. 

-ERROR- X.25 interface <name> is not defined for this system. 

-ERROR- X.25 interface <name> already started for trunk < trunk _ 
name>. 

-ERROR- Trunk < trunk _name> down. Unable to start X.25 interface 

< interface _name > . 

-ERROR- Trunk < trunk _name> off. Unable to start X.25 interface 

< interface _name > . 

—FATAL— Stream Service Error. Error code = < error _code>. 

—FATAL— Unable to start task < entry _point_name>. 

-FATAL- X.25 interface <name> not responding - interface 
unconditionally stopped. 

-FATAL— X.25 interface <name> reported error - interface 
unconditionally stopped. 

Examples start_x25_1nterface 1n*telenet_1nf 

X.25 Interface TELENET_INF started on trunk TELENET2. 
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START_X25_TERMINAL_GW (STAXTG) 
NETOU Command 

Purpose Starts the specified X.25 terminal gateway. If ADDXTGO commands have 
been entered for the associated gateway name or the ODR parameter is 
FALSE, it registers the title defined for the gateway in the CDCNET 
directory. 

Format START_X25 JTERMIN AL GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

Specifies the logical name of an X.25 terminal gateway defined by a 
DEFXTG command. 

Responses X.25 terminal gateway <name> is started. 

X.25 terminal gateway <name> is started and awaiting outcall 
definitions. 

-ERROR- X.25 terminal gateway <name> is already started. 
-ERROR- X.25 terminal gateway < gateway _name> is not defined. 
Examples start_x25_terminal_gw gn=datapac_terminal_gateway 

X.25 terminal gateway DATAPAC_TERMINAL_GATEWAY Is started. 
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This chapter provides complete descriptions of all CDCNET Network Operations STOP 
commands. Command descriptions are organized alphabetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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STOP_CIM_TEST (STOCT) 
NETOU Command 

Purpose Stops an online diagnostics test running on a Communications Interface 
Module (CIM) and its LIMs. 

Format STOP_CIM JTEST 

DEVICE _NAME = name 

Parameters DEVICE _NAME (DN) 

Physical name of the CIM, derived from its type (CIM) and its board slot 
number. Allowed range is $CIM 0..7. For example, $CIM3 is the physical 
name for a CIM board in slot 3. 

Responses CIM test stop flag set, version < version _number>. 
CIM slot number = <cim slot_number>. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- CIM test not running. 

CIM slot number = <cim slot number >. 

Remarks To get the results of the CIM test, send the DISPLAY_TEST_STATUS 
command, described in this manual, to the DI that contains the device 
being tested. 

Examples stop_c1m_test dev1ce_name=$cim5 

CIM test flag set, version 7606 
CIM slot number = 5. 
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STOP_EGP_PEER (STOEP) 
NETOU Command 

Purpose Stops the exchange of routing information with the specified peer. Begins 
Exterior Gateway Protocol (EGP) 'cease 1 processing with the peer, if the 
peer is acquired. If the peer is not acquired and is defined as a backup 
peer, then the specified peer is removed from the eligibility as a backup. 
This command reverses the effect of the START_EGP_PEER command 
described in this manual. 

Format STOPJBGP_PEER 

IP.ADDRESS = list 4 of 0..255 

Parameters IP_ADDRESS (IA) 

Identifies the IP address of the EGP peer gateway with which exchange of 
routing information is to be stopped. 

Responses EGP peer <ip_address> is stopped. 

EGP peer <ip_address> is not idle. 'Cease' process initiated. 

—WARNING- EGP peer <ip_address> is already stopped. 

-ERROR- EGP peer <ip .address > is not defined. 
Examples stop_egp_peer Ip.address = (128,5,0,3) 



EGP peer 128.5.0.3 Is stopped. 
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STOPJESCI JTEST (STOET) 
NETOU Command 

Purpose Stops an online diagnostics test running on an Ethernet Serial Channel 
Interface (ESCI). 

Format STOP_ESCI _TEST 

DEVICE _NAME = name 

Parameters DEVICE _NAME (DN) 

Physical name of an ESCI board consisting of a dollar sign ($), board type 
(ESCI) and its board slot number (0..7). For example, $ESCI4 is the 
physical name of an ESCI board in slot 4. 

Responses ESCI test stop flag set, version < version _number>. 
ESCI slot number = < ESCI _slot .number >. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- < Device > test not running ESCI slot number = <esci slot 
number >. 



Remarks 



To get the results of the ESCI test, send the DISPLAY_TEST_STATUS 
command described in this manual to the DI that contains the device being 
tested. 



Examples stop_esd_test device_name=$esc16 

ESCI test flag set, version 7606 
ESCI slot number = 6. 
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STOP_LIM JTEST (STOLT) 
NETOU Command 



Purpose 
Format 



Stops the online diagnostics running on a LIM board and its ports. 



STOP_LIM_TEST 

DEVICE _NAME = name 



Parameters DEVICE _NAME (DN) 

Physical name of LIM device, consisting of a dollar sign ($), board type 
(LIM) and slot number, as in $LM5 (device name for LIM board in slot 5). 

Responses You receive one of the following responses when this command is executed. 

LIM test stop flag set, version < version ...number >. 
CIM Slot number = <cim_slot_number>. 
LIM Slot number = <lim_slot_number>. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- LIM test not running. 

CIM Slot number = <cim_slot_number>. 

LIM Slot number = <lim_slot_number>. 



Remarks 



To get the results of the LIM test, send the DISPLAY_TEST_STATUS 
command described in this manual to the DI that contains the device being 
tested. 



Examples stop_1im_test device_name=$11m2 

LIM test flag set. version 7606 
CIM Slot number = 5. 
LIM Slot number - 2. 
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STOP_LINE (STOL) 
NETOU Command 

Purpose Stops communications over a communication line or a URI line. 

Format STOP_LINE 

LINE_NAME = name 

Parameters LINE_NAME (LN) 

Logical name of the line assigned by the DEFINE _LINE command that 
configured the line. 

Responses Line <line_name> stopped. 

—WARNING- Line <line_name> already stopped. 

-ERROR- Line <name> not defined for this system. 

—ERROR- Line <name> down, hardware status indicates port is in a 
DOWN or OFF state. 

—FATAL— Line shutdown failure. 

Examples stop_line I1ne_name=engln_bld_31 

Line ENGIN_BLDG_31 stopped. 
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STOP_LINE ..METRICS (STOLM) 
NETOU Command 

Purpose Stops the collection and reporting of statistics at a statistics level for one 
or more communication lines or URI lines. Statistics are immediately 
reported for the stopped line statistics. Any statistics groups not specifically 
stopped continue to be collected and reported. 

Format STOP_LINE .METRICS 

LINE .NAME = list 1..15 of name 
GROUP = list 1.2 of keyword value 

Parameters LINE .NAME (LN) 

Logical name or names of the line or lines for which you want to stop 
statistics collection and reporting. 

GROUP (G) 

Statistics group for which you want to stop collection and reporting. 
Possible keyword values include the following: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is ALL. 

Responses You receive the following response if the line metrics successfully stopped. 

Line < line .name > < group _name> metrics stopped. 

(One response for each line and group specified in the command.) 

-WARNING- Future CDCNET releases will only support start/stop 
trunk metrics commands. Please replace start/stop line metrics 
commands with start/stop trunk metrics commands. 

For lines that are not defined or if the metric was not started, the 
following lines are displayed. 

Line <line_name> not defined. 

Line < line .name > < group .name > metrics not started. 

-FATAL- Line < line .name > metrics shutdown failed. 

Examples stop. 1 1 ne_met r 1 cs 11 ne_name= ( 1 1 ne_303 , 1 1 ne_305 , . . 
1 1ne_306, 1 1ne_310) ,g=( summary .expanded) 

Line LINE.303 summary metrics stopped. 
Line LINE_303 expanded metrics stopped. 
Line LINE_305 summary metrics stopped. 
Line LINE.305 expanded metrics stopped. 
Line LINE.306 summary metrics stopped. 
Line LINE.306 expanded metrics stopped. 
Line LINE.310 summary metrics stopped. 
Line LINE.310 expanded metrics stopped. 
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STOP JMCI .INLINE JTEST (STOMIT) 
NETOU Command 

Purpose Stops the inline diagnostics test executing on an MCI board. 

Format STOP.MCI .INLINE TEST 

DEVICE .NAME = name 

Parameters DEVICE .NAME (DN) 

Physical name of the device to be tested, consisting of a dollar sign ($), 
board type (MCI, in this case), and slot number. This parameter has no 
default value. 

Responses Stopped the MCI in line test 
for device < device name>. 

-ERROR-- Device < device .name > is not installed in system. 

-ERROR-- Device < device .name > is not a MCI board. 

-ERROR- MCI in line test for device < device .name > is not running. 

-ERROR- MCI in line test for device < device .name > was terminated. 
However, no termination response was received from the in line diagnostics 
test. 

Examples stop_mc1_1nl1ne_test dn=$mci6 

Stopped the MCI In line test 
for device $mci6 
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STOP_MCI_TEST (STOMT) 
NETOU Command 

Purpose Stops the online diagnostic running on the MCI. 

Format STOP_MCI JTEST 

DEVICE _NAME = name 

Parameters DEVICE _NAME (DN) 

Physical name of the MCI. The physical name consists of a dollar sign $, 
board type (MCI), and the slot number, as in $MCI6 (device name for an 
MCI in slot 6). There is no default value. 

Responses MCI test stop flag set, version < version number > 
MCI slot number = <mci slot number >. 

-ERROR— Device < device _name> not installed in system. 

-ERROR- MCI test not running. 

MCI slot number = <mci slot number > 

Examples stop_md_test dn=$mci6 

MCI test stop flag set, version 7606 
MCI slot number = 6 
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STOP_NET_DELAY_MEASUREMENT (STONDM) 
NETOU Command 

Purpose Stops execution of the network delay measurement. The internal control 

flag, STOP_FLAG, is set causing the measurement to be terminated when 
the task next checks the flag. The flag is tested by the measurement task 
once a second to allow the user to stop a task without waiting for any 
lengthy timeouts. 

Format STOP_.NET JDELAY_MEASUREMENT 

DESTINATION .SYSTEM = name 

Parameters DESTINATION _SYSTEM (DS) 

Specifies the system name, which the network delay measurement is to be 
made, from the source (originating) system. This is the name as designated 
by the DESTINATION .SYSTEM parameter on the START_NET_DELAY_ 
MEASUREMENT command. 

Responses Network Delay Measurement to < destination _system> is being stopped. 

-ERROR- Network Delay Measurement to < destination _system> is not 
active. 

—ERROR- System < destination _system> is unknown. 

-ERROR- Destination system < destination _system> is not a CDCNET 
OSI system. 

Examples senc 'stop_net_delay_measurement dest1nation_system=nd1_1' s=md1_a1 

FROM MDI.A1 

Network Delay Measurement to NDI_1 1s being stopped. 
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STOPJNTETWORK (STON) 
NETOU Command 

Purpose Stops communications over a network solution, such as Ethernet, X.25, or 
HDLC. For Ethernet or HDLC network, STOP_NETWORK also stops the 
underlying trunk. For an X.25 network, STOP_NETWORK clears the 
virtual circuit underlying the network, but does not stop the Packet Level 
interface or X.25 trunk supporting the network. Those elements of the X.25 
interface must be stopped by the STOP_X25_INTERFACE command 
described in this manual. 

A STOP_NETWORK command is the same as a STOPJTRUNK command, 
except for HDLC rotary trunks. Both STOP_NETWORK and STOP_ 
TRUNK stop the communication media. A STOPJTRUNK command does 
not work for X.25 trunks; only the STOP_NETWORK or STOP_X25_ 
INTERFACE command stops the media of communication for X.25. The 
only time it makes sense to use STOPJTRUNK is for HDLC rotaries. To 
stop only one of the HDLC rotary trunks, use STOPJTRUNK. If all HDLC 
rotary trunks are to be stopped, use STOP_NETWORK . 

Format STOP_NETWORK 

NETWORK _NAME = name 

Parameters NETWORK .NAME (NN) 

The logical name of the network assigned by a define command. 

< Network _type> network <name> stopped for trunk < trunk _name>. 



Responses 



Examples 



< Network _type> network <name> stopped for trunks (< trunk _name> 
<trunk_name>..). 

-WARNING- Network <name> already stopped for trunk < trunk _ 
name>. 

-WARNING- The 3A Command Processor has timed- out waiting for 

response from SSR. 

Please check network status for completion of request. 

-ERROR- Network <name> is not defined. 

-FATAL- Stream Service Error. (See below.) 

The device manager did not accept a function for the ESCI board. 

HDLC SSR received error when sending command to DVM. 

stop_network network_name=tymnet_net_1 



X.25 Network TYMNET_NET_1 stopped for trunk TYMNET.TRUNK1 . 
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STOP_NETWORK JV1ETRICS (STONM) 
NETOU Command 

Purpose Stops the collection and reporting of statistics at a statistics level for one 
or more network solutions. Statistics are immediately reported for the 
stopped network statistics. Any statistics groups not specifically stopped 
continue to be collected and reported. 

Format STOP.NETWORK .METRICS 

NETWORK _NAME = list 1..15 of name 

GROUP = list 1.2 of keyword value 

Parameters NETWORK .NAME (NN) 

Logical names of the network solutions for which you want to stop 
statistics collection and reporting. 

GROUP (G) 

Statistics group whose collection and reporting you want to stop. Possible 
keyword values include the following: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is ALL. 

Responses You receive the following response if the network metrics successfully 
stopped. 

Network < network _name> < group _name> metrics stopped 

(one response for each network and group specified in the command). 

For networks that are not defined, or if the metric was not started, the 
following lines are displayed. 

Network < network _name> not defined. 

Network < network _name> < group _name> metrics not started. 

-FATAL- Network < network _name> metrics shutdown failed. 

Examples stop-network_metr1cs .. 

net work_name=bld_3_ethernet,group=(summary, expanded) 

Network BLD_3_ETHERNET summary metrics stopped. 
Network BLD_3_ETHERNET expanded metrics stopped. 
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STOPJ*P_GW (STONG) (NOS MDI Only) 

STOP_NP_GW (STONG) (NOS MDI Only) 
NETOU Command 

Purpose Disconnects any application-to-application (A-to-A) connections supported by 
a Network Products A-to-A gateway and deletes the title or titles 
registered for the gateway in the CDCNET directory. STOP_NP_GW 
inactivates any title or titles added with the ADD_X25_OUTCALL 
command described in this manual. These titles remain known to the 
gateway and are reactivated when the gateway is restarted. STOP_NP_GW 
both stops and cancels the Network Products A-to-A gateway. The STOP_ 
NP_GW command essentially removes the gateway from use. 

Format STOP_NP_GW 

GATEWAY_NAME = name 

Parameters GATEWAY.NAME (GN) 

The logical name assigned to a Network Products gateway by a DEFINE _ 
NP_GW command described in this manual. 

Responses NP gateway < gateway _name> stopped. 

—ERROR— NP gateway <name> not defined or already stopped. 
Examples stop_np_gw gn=a_to_a_109 s=md12 

NP gateway A_TO_A_109 stopped. 
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STOPJSPJNTEEFACE (STONI) (NOS MDI Only) 

STOP_NP_INTERFACE (STONI) (NOS MDI Only) 
NETOU Command 

Purpose Stops the Network Products (NP) protocol over a mainframe channel to a 
NOS system and stops the underlying channel trunk protocol. The Network 
Products interface is addressed by its interface name. 

Format STOP_NP_INTERFACE 

INTERFACE _NAME = name 

Parameters INTERFACE _NAME (IN) 

The logical name of the Network Products interface assigned by a define 
command. 

Responses NP_interface < interface _name> stopped. 

-WARNING-- NP interface < interface _name> already stopped. 

-ERROR- NP interface < interface _name> is not defined. 

-FATAL- NP interface < interface _name> command processor has 
timed- out waiting for a response from the NP interface task. 

-FATAL- Unable to stop the NP interface <interface_name>. 
Unable to send ITM to NP interface task. 

Examples stop_np_interface 1n=cyber_109 
NP Interface CYBER_109 stopped. 
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STOP_NP_TERMINAL_GW (STONTG) 

STOP_NP__TERMINAL_GW (STONTG) 
NETOU Command 

Purpose Disconnects any terminal-to-application connections supported by a Network 

Products (NP) interactive gateway, and deletes the titles registered for the 
gateway in the CDCNET directory. The command removes the NP terminal 
gateway from use. 

Format STOP.NPJTERMINAL _GW 

GATEWAY.NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of an NP terminal gateway, assigned by a DEFINE _NP_ 
TERMINAL _GW command described in this manual that configured the 
gateway. 

Responses NP terminal gateway <name> stopped. 

-ERROR— NP terminal gateway name not defined or already stopped. 
Examples stop_np_term1nal_gw gn=ivt109 

NP terminal gateway IVT109 stopped. 
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STOP_0UTCALL_GATEWAY (STOOG) 

STOP_OUTCALL__GATEWAY (STOOG) 
NETOU Command 

Purpose Stops the Outcall Gateway. Stopping the Outcall Gateway causes all 

existing DEVICE _OUTCALL and Passthrough connections in the DI to be 
terminated. 

Format STOP.OUTCALL .GATEWAY 

Parameters None. 

Responses Outcall Gateway is stopped. 

-WARNING- Outcall Gateway is already stopped. 

-ERROR- Outcall Gateway is not defined. 
Examples stop_outca1 1 .gateway 

Outcall Gateway Is stopped. 
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STOPJPASSTHROUGHJSERVICE (STOPS) 

STOP_PASSTHROUGH_SERVICE (STOPS) 
NETOU Command 

Purpose Stops the Interactive Passthrough Service. This command terminates all 
existing passthrough connections in the DI. 

NOTE 

In future releases, this command will no longer be supported. You should 
start using the STOP_OUTCALL_GATEWAY command as soon as possible. 

Format STOP_PASSTHROUGH ^SERVICE 

Parameters None. 

Responses Passthrough Service stopped. 

-ERROR— Passthrough Service not defined or already stopped. 
Examples stop_passthrough_service 

Passthrough Service stopped. 
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STOPJPORTJTEST (STOPT) 
NETOU Command 



Purpose 
Format 

Parameters 



Responses 



Remarks 



Stops an online diagnostics test running on an individual LIM port. 

STOP.PORTJTEST 

DEVICE .NAME = name 

DEVICE _NAME (DN) 

Physical name of the port, consisting of a dollar sign ($) board type (LIM) 
its slot number, the keyword PORT and port number. For example, 
$LIM3_PORTl is the device name for port 1 on the LIM board in slot 3. 

PORT test stop flag set, version < version _number>. 
CIM Slot number = <slot_number>. 
LIM Slot number = <slot_number>. 
PORT Slot number = <slot_number>. 

-ERROR- Device < device _name> not installed in system. 

-ERROR- Port test status 

CIM slot number = <cim slot number > 

LIM slot number = <lim slot number > 

Port number = <port number > 

To get the results of the LIM test, send the DISPLAY_TEST_STATUS 
command (described in this manual) to the DI that contains the device 
being tested. 



Examples stop_port_test device_name=$11m3_port2 

Port test stop flag set, version 7606 
CIM slot number = 5 
LIM slot number = 3 
Port slot number ■ 2 
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STOP_PROCESS JVLETRICS (STOPM) 
NETOU Command 

Purpose Stops the collection and reporting of statistics at a statistics level for a 
software process. Statistics are immediately reported for the stopped 
process statistics. Any statistics groups not specifically stopped remain in 
effect. 

Format STOPJPROCESS JV1ETRICS 

PROCESS = list 1-15 of name 
GROUP = list 1..3 of keyword value 

Parameters PROCESS (P) 

Specifies the name of the communications system process for which 
statistics collection and reporting is to stop. The following keywords are 
supported. 

command 

directory 

dod_internet 

independent _log_me (source log) 

intranet (summary) 

intranet (expanded) 

log_support_application (source log) 

osa (Operator Support Application) 

session 

system 

tcp (Transmission Control Protocol) 

tcp/ip external gateway protocol (EGP) 

clns 

es_is_routing 

channel .connection 

tcp/ip user datagram protocol (udp) 

transport (summary) 

transport (expanded) 

np_ivt_gw 

is _is ...routing 

cons 

llc_2 

GROUP (G) 

Specifies the level of statistics collection to stop. Specify one of the 
following levels: 

SUMMARY (S) 
EXPANDED (E) 
DEBUG (D) 

ATT / K\ 

Default is ALL. 
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STOPJPROCESS.JJETRICS (STOPM) 

Responses You receive the following response if the process metrics successfully 
stopped. 

< process > < group > metrics stopped 

For process metrics not stopped because of errors during command entry, 
processes that are unknown, or processes for which the metric was not 
started, the following lines are output. 

Process <process> unknown 

< process > < group > metrics not started 
-FATAL- < process > metrics shutdown failed 

Examples stop_process_met r 1 cs p=intranet,g=( summary, expanded) 

INTRANET summary metrics stopped 
INTRANET expanded metrics stopped 
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STOPJ3ERVER_TELNET_GW (STOSTG) 

STOP_SERVER_TELNET_GW (STOSTG) 
NETOU Command 

Purpose Stops the host terminal gateway service. The gateway terminates any 
established connections and stops listening for new connections. This 
commandmanual reverses the effect of a START_SERVER_TELNET_GW 
command described in this manual. 

Format STOP_SERVER .TELNET GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the server TELNET host gateway defined by a 
DEFINE _SERVER_TELNET_GW command described in this manual. 

Responses Server TELNET gateway < gateway _name> is stopped. 

--WARNING- Server TELNET gateway < gateway _name> is already 
stopped. 

-ERROR- Server TELNET gateway < gateway _name> is not defined. 

Examples stop_server_telnet_gw gateway_name=gw_to_cyber 

Server TELNET gateway GW_TO_CYBER 1s stopped. 



60000414 F 



STOP Commands 13-21 



ST0PJ3LIP_GW (STOSG) 



STOP_SLIP GW (STOSG) 
NETOU Command 

Purpose Stops the SLIP gateway service. The gateway terminates any established 
connections and takes titles associated with this gateway interface out of 
registration. This command reverses the effect of a START_SLIP_GW 
command. 

Format STOP_SLIP_GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the SLIP gateway previously defined in a DEFINE _ 
SLIP_GW command. This parameter is required. 

Responses SLIP gateway < gateway _name> is stopped. 

-WARNING- SLIP gateway < gateway _name> is already stopped. 

-ERROR- SLIP gateway < gateway _name> is not defined. 
Examples stop_sl lp_gw gateway_name=sl 1p_gw 

SLIP gateway SLIP_GW Is stopped. 



13-22 CDCNBT Commands 



60000414 F 



ST0P_3UBNET_C0NNECT_TEST (STOSCT) 

STOP_SUBNET_CONNECT_TEST (STOSCT) 
NETOU Command 

Purpose Stops the test execution of the online diagnostic started by the STASCT 
command described earlier in this manual. 

Format STOP_SUBNET_CONNECT_TEST 

SUBNET_NAME = name 

Parameters SUBNET_NAME (SN) 

Specifies the name of the subnet being tested by the STASCT command. 

Responses Subnet Connect Test on < subnet _name> is being stopped. 

-ERROR- Subnet < subnet _name> is unknown. 

-ERROR- Subnet Connect Test on < subnet _name> is not running. 
Examples stop_subnet .connect _t est sn*SUBNET_1 

Subnet Test on SUBNET_1 Is being stopped. 
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STOP_TCPIP_GW (STOTG) 

STOP_TCPIP_GW (STOTG) 
NETOU Command 

Purpose Stops the TCP/IP application interface gateway. The gateway terminates 
any established connections and deregisters (clears) all titles associated 
with this gateway interface. This command reverses the effect of a 
START__TCPIP_GW command. 

Format STOPJTCPIP GW 

GATEWAYlNAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the TCP/IP application gateway defined by a 
DEFINE _TCPIP_GW command described in this manual. 

Responses TCP/IP gateway < gateway _name> is stopped. 

-WARNING- TCP/IP gateway < gateway _name> is already stopped. 

-ERROR- TCP/IP gateway < gateway _name> is not defined. 

-FATAL- TCP/IP gateway was unable to deregister title <title>. 
Examples stop_tcpip_gw gateway_name=ftp_gw 

TCP/IP gateway FTP_GW 1s stopped. 
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STOPJTRACE_PROCESS (STOTP) 

Purpose Stops the collection of trace information for the given process. 

Format STOPJTRACE ..PROCESS 

PROCESS = name 

Parameters PROCESS (P) 

Specifies the name of the trace process to be stopped. 

Responses TRACE stopped for process <name>. 

-ERROR- TRACE not active for process <name>. 
Examples stop_trace_process processor ansport 

TRACE stopped for process TRANSPORT. 
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STOPJTRUNK (STOT) 
NETOU Command 

Purpose Stops communications over an HDLC, X25, or Ethernet trunk. This is the 
same as STOP_NETWORK except for HDLC rotary (multiple trunk) 
networks. The STOPJSTETWORK command stops all the HDLC trunks 
defined for the HDLC network. The STOPJTRUNK command stops only 
the given HDLC trunk. Use the STOP_NETWORK command except for 
rotary HDLC networks and when you want to stop specific trunks. 

For an X.25 trunk, the command STOP_X25 JNTERFACE stops hoth the 
X.25 interface and the underlying media. For this reason, STOPJTRUNK 
does not work with a defined X.25 trunk. The error returned when you try 
to use STOPJTRUNK with an X.25 trunk is: 

-ERROR- Unknown trunk type. 

Format STOPJTRUNK 

TRUNK _NAME = name 

Parameters TRUNK _NAME (TN) 

Specifies the logical name of the trunk assigned by the DEFINE command 
that configured the trunk. 



Responses Trunk <name> stopped. 



Examples 



-WARNING- 
name>. 



Network <name> already stopped for trunk < trunk. 



-WARNING- The 3A Command Processor has timed out waiting for 
response from SSR. Please cheek network status for completion of request. 

-ERROR- Trunk <name> not defined. 

-ERROR- Unknown trunk type. 

-FATAL- Stream Service Error. {This response includes one of the 
following error messages.} 

The device manager did not accept a function for the ESCI board. 

HDLC SSR received error when sending command to DVM. 
stop_trunk trunk_name = menlo_park_trunk_1 
Trunk MENL0_PARK_TRUNK_1 stopped. 
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STOP_TRUNK_METRICS (STOTM) 



STOp TRUNK .METRICS (STOTM) 
NETOU Command 

Purpose Stops the collection and reporting of statistics at a statistics level for one 
or more trunks. Statistics are immediately reported for the stopped trunk 
statistics. Any statistics not specifically stopped continue to be collected 
and reported. 

Format STOPJTRUNK .METRICS 

TRUNK _NAME = list 1..15 of name 
GROUP = list 1.2 of keyword value 

Parameters TRUNK _NAME (TN) 

The logical names of one or more trunks for which you want to stop 
statistics collection and reporting. 

GROUP (G) 

Statistics group for which you want to stop collection and reporting. 
Possible keyword values include the following: 

SUMMARY (S) 
EXPANDED (E) 
ALL (A) 

Default is SUMMARY. 

Responses The following response is sent for each trunk and group for which metrics 
were stopped. 

Trunk < trunk _name> < group > metrics are stopped. 

The following display contains the following lines for trunks that are not 
defined and started or the metrics that were never started. 

Trunk < trunk _name> is not defined and started. 

< trunk _name> < group > metrics are not started. 

-ERROR- A network or interface is not defined and started for trunk 

< trunk _,name > . 



Examples 



-FATAL— Trunk < trunk _name> metrics shutdown failed. 

stop_trunk_metr1cs tn« bld_3_trunk, . . 
g= ( summary , expanded ) 



Trunk BLD_3_TRUNK summary metrics are stopped. 
Trunk BLD_3_TRUNK expanded metrics are stopped. 
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STOP_UDPJNTERFACE (ST0U1) 

STOP_UDP__INTERFACE (STOUI) 
NETOU Command 

Purpose Stops the User Datagram Protocol (UDP) layer interface. Closes all UDP 

service access points (SAPs), after which no new open SAP requests are 
honored. 

Format STOP_UDP_INTERFACE 

Parameters None. 

Responses UDP interface is stopped. 

-WARNING- UDP interface is already stopped. 

-ERROR- UDP interface is not defined. 
Examples stop_udp_interface 

UDP Interface is stopped. 
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STOP_URI_TEST (STOUT) 
NETOU Command 

Purpose Stops the online diagnostic test running on' a URI. 

Format STOP_URI _TEST 

DEVICE .NAME = name 

Parameters DEVICE .NAME (DN) 

Physical name of the URI, consisting of a dollar sign ($), board type (URI), 
and its slot number. 

Responses URI test stop flag set, version < version number > 
CIM slot number = <cim slot number > 
URI slot number = <uri slot number > 

—ERROR— Device < device _name> not installed in system. 

-ERROR- URI test not running. 

CIM slot number = <cim slot number > 

URI slot number = <uri slot number > 



Examples 



stOD_uri_test dn=$ur15 



URI test stop flag set, version 2301 
CIM slot number* 3 
URI slot number = 5 
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STOP_USER_TELNET_GW (STOUTG) 



STOP_USER_TELNET_GW (STOUTG) 
NETOU Command 

Purpose Stops the user TELNET interactive terminal gateway service. The gateway 
terminates any established connections and deregisters (clears) titles 
associated with this gateway interface. No new connections can be 
established. This command reverses the effect of a START_USER_ 
TELNET_GW command described in this manual. 

Format STOP.USER JTELNET.GW 

GATEWAY_NAME = name 

Parameters GATEWAY_NAME (GN) 

The logical name of the user TELNET gateway defined by a DEFINE _ 
USER_TELNET_GW command described in this manual. 

Responses User TELNET gateway < gateway _name> is stopped. 

-WARNING- User TELNET gateway < gateway _name> is already 
stopped. 

-ERROR- User TELNET gateway < gateway _name> is not defined. 
Examples stop_user_telnet_gw gateway_name=vax_gw 

User TELNET gateway VAX_GW Is stopped. 
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STOPJC25 - ASYNCTIP (STOXA) 

STOP_X25_ASYNCTIP (STOXA) 
NETOU Command 

Purpose Stops X.25 asynchronous TIP service for the specified X.25 trunks. 

Disconnects any active terminal connections through the X.25 asynchronous 
TIP for the specified trunk. 

Format STOP.X25 .ASYNCTIP 

TRUNK _NAME = list 1..32 of name 

Parameters TRUNK _NAME (TN) 

Logical name of one or more X.25 trunks for which X.25 asynctip service 
is to be stopped. 

Responses X.25 AsyncTip support stopped for specified trunks. 

X.25 AsyncTip support already stopped for trunk < trunk _name>. 

-ERROR- X.25 AsyncTip support not defined for trunk < trunk _name>. 

-ERROR- Duplicate trunk name < trunk _name> specified. 
Examples stop_x25_asynct 1 p trunk_name ■ telenet_2 

X.25 AsyncTip support stopped for specified trunks. 
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STOPJC25_GW (STOXG) 

STOP_X25_GW (STOXG) 
NETOU Command 

Purpose Disconnects any application-to-application connections supported by the X.25 
transparent gateway and deletes the title(s) registered for the gateway in 
the CDCNET directory. The STOP_X25_GW command removes the X.25 
gateway from use. 

Format STOP_X25 GW 

GATEWAY_NAME = name 

Parameters GATEWAY.NAME (GN) 

The logical name assigned to an X.25 gateway by a DEFINE _X25_GW 
command described in this manual. 

Responses X.25 gateway <name> stopped. 

-WARNING- X.25 gateway <name> is already stopped. 

-ERROR- X.25 gateway <name> is not defined. 
Examples stop_x25_gw gateway_name=telenet_gw 

X.25 gateway TELENET.GW stopped. 
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STOP_Jt26 JNTERFACE (STOXI) 

STOP_X25 .INTERFACE (STOXI) 
NETOU Command 

Purpose Stops the specified X.25 Packet Level interface. The STOP_X25_ 

INTERFACE command stops the X.25 Packet Level protocol on the X.25 
trunk supported by the interface, and also stops the underlying X.25 trunk. 

Format STOP.X25 .INTERFACE 

INTERFACE .NAME = name 

Parameters INTERFACE .NAME (IN) 

The logical name assigned to an X.25 interface by a DEFINE _X25_ 
INTERFACE command described in this manual. 

Responses X.25 interface <name> stopped on trunk < trunk .name >. 

-WARNING- X.25 interface <name> already stopped. 

—ERROR— X.25 interface <name> is not defined for this system. 
Examples stop_x25_interface 1nterface_name=telenet_1f 

X.25 interface TELENET.IF stopped on trunk TELENET2. 
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STOP_X25_TERMINAL_GW (STOXTG) 

STOP_X25_TERMINAL GW (STOXTG) 
NETOU Command 

Purpose Stops the X.25 terminal gateway. Also, deletes the title registered for the 
gateway in the CDCNET directory. 

Format STOP_X25 .TERMINAL GW 

GATEWAY.NAME = name 

Parameters GATEWAY_NAME (GN) 

Specifies the logical name assigned to the gateway by a DEFXTG 
command. 

Responses X.25 terminal gateway <name> is stopped. 

-WARNING- X.25 terminal gateway <name> is already stopped. 

-ERROR- X.25 terminal gateway <name> is not defined. 
Examples stop_x25_terminal_gw gateway.name » datapac_terminal_gateway 

X.25 terminal gateway DATAPAC_TERMINAL_GATEWAY is stopped. 
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STOP_X25_VIRTUAL_CIRCUIT (STOXVC) 

NETOU Command 

Purpose Stops the identified virtual circuit on the specified X.25 trunk to clear the 

circuit. 

Format STOP_X25_VIRTUAL_CIRCUIT 

VIRTUAL_CIRCUIT = string or integer 

TR UNK_NAME = name 

Parameters VIRTUAL_CIRCUIT (VC) 

Specifies the virtual circuit number assigned to the X.25 virutal circuit that is 
to be stopped. This parameter can be specified as either a string or an 
integer. This parameter can be one of the following: 

$CONSOLE name, which includes the TRUNK_NAME (and DI), specified 
as a string. If the TRUNK_NAME parameter is specified, it is validated 
against the TRUNK_NAME part of the console name. 

The 10-digit number (base 10) as it appears in the 

DISPLAY_CONNECTION output display, specified as a string. This 10- 
digit number includes the TRUNK_NAME and the VIRTUAL_CIRCUIT 
number. If the TRUNKJStAME parameter is specified, it is validated 
against the TRUNKJSTAME part of the 10-digit number. 

Logical channel number (base 8, 10, or 16; the default is 10). An error is 
returned if the 77? JJNKJNAME parameter is not also specified. 

TRUNKJSAME (TN) 

Specifies the logical name of the X.25 trunk on which the virtual circuit to be 
stopped resides. If TR UNKJSJAME is not specified, the trunk must be 
included in the VIRTUAL_CIRCUIT parameter. 
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Commands 14 

The command descriptions in this chapter are organized alphabetically by full command 
name. Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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SYNCHRONIZE_CL0CK (SYNC) 

SYNCHRONIZE .CLOCK (SYNC) 
NETOU Command 

Purpose Sets a DI's date and time to the master date and time for a catenet. 

The master date and time is maintained by a DI or NOS/VE system that 
contains the network-wide clock management function. The master date and 
time for the catenet is set in a DI by the SET_DATE_AND_TIME 
command (described in this manual) and on the NOS/VE system according 
to the system's date and time. When the SYNCHRONIZE _CLOCK 
command is sent to a DI, the DI's clock is set to the master date and 
time. 

Format SYNCHRONIZE .CLOCK 

Parameters None. 

Remarks System clock synchronized. 

-FATAL- Unable to access master clock through Independent Clock M-E. 

-FATAL- Unable to synchronize system clock, version number mismatch. 

-FATAL- Unable to synchronize system clock, retry limit reached. 
Examples synchron1ze_clock 

System clock synchronized. 



14-2 CDCNET Commands 60000414 C 



UNLOAD_FILE (UNLF) 



UNLOAD JFILE (UNLF) 
NETOU Command 

Purpose Removes a CDCNET file from DI memory residency. The buffers occupied 
by the file are released to the system. 

Format UNLOAD.FILE 

FILE = name or string 1..63 
FILEJTYPE = name 

Parameters FILE (F) 

The name of the file to be unloaded. File names entered as strings are 
converted to uppercase and are restricted to the character set of SCL type 
name. 

FILEJTYPE (FN) 

Specifies the type of file to be loaded. Valid file types include the 
following: 

EXCEPTION _LIST 

TERMINAL_DEFINITION .PROCEDURE 
TERMINAL_USER .PROCEDURE 
DEVICE _LOAD_PROCEDURE 
VALIDATION 

Default is USER_PROCEDURE. 

Responses File <name> is unloaded. 

-WARNING- File <name> is not currently loaded. 

Remarks The format of VALIDATION file names is ^sernametgdomain 1 . Username 

and domain are 1- through 31-character names. Both username and domain 
must be specified. 

Examples unload.flle f=pr1nter_w1th_vfu_p31310 

File pr Inter _w1th_vfu_p31310 1s unloaded. 
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UNLOADJHODULE (UNLM) 
NETOU Command 

Purpose Marks a module as a candidate for unloading from a DI. This command 
clears the retain flag from the module so that when the module is no 
longer used, the module can be unloaded if memory is needed. 

An unloaded module may be reused by the system if the module remains 
resident in a DI. UNLOAD_MODULE does not guarantee that the module 
is immediately unloaded or that a new copy of the unloaded module is 
used. 

Format UNLOAD.MODULE 

MODULE = name 
ENTRY_J>OINT = name 

Parameters MODULE (M) 

The name of the desired software module. 

ENTRY_POINT (EP) 

The entry point name used to determine which module to make a 
candidate for unloading. 

Responses Module < module > retain removed. 

-ERROR- Entry point < entry point > is not contained within module 
< module >. 

-ERROR- Module for entry point < entry point > was not found. 

-ERROR- Module < module > not currently loaded. 

-ERROR- Module < module > not previously retained. 

-ERROR- One of the parameters Module or Entry Point must be specified. 



Remarks 



Examples 



To display the modules currently loaded and/or marked for unloading in a 
DI, send the DISPLAY_SOFTWARE_LOAD_STATUS command described 
in this manual to the DI. 

un1oad_module m=display_hardware_status 

Module CMD_DISPLAY_HARDWARE_STATUS retain removed. 
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WRITE ..TERMINAL ..MESSAGE (WRITM) 
NETOU Command 



Purpose Sends a message to an interactive terminal or group of terminals, 

including the control consoles for batch workstations. This command allows 
you to send informative or warning messages to network users or to 
respond to a network user's request. 

You may choose the terminals to which the message is sent by three 
attributes: line name, terminal device name, or connected service. 
Specifying these attributes limits the number of terminals receiving a 
message to those terminals that match the specified attributes. 

If you do not specify any attributes with the command and message, then 
all terminals with at least one active session receive the message. 

You can restrict the number of terminals receiving a message by sending 
the WRITM command to only the DIs to which the desired terminals are 
attached. 

Format WRITE .TERMINAL .MESSAGE 

MESSAGE = list 1..15 of string 
UNE_NAME = list 1..15 of name 
DEVICE _JfAME = list 1..15 of name 
SERVICE JWAME = list 1..15 of name 

Parameters MESSAGE (M) 

Text of the message to the terminal user. This message must be enclosed 
by apostrophes. Since this command is sent as a string value within 
SEND .COMMAND, you must begin and end the message with two 
consecutive apostrophes so that the message is distinguished as a string 
value within another string value. For a list of strings, each string is 
output as one display line. The message may be any text up to 245 
characters long. For example, the text ('Please log off by 14:00','Network 
temporarily down for diagnostics') produces the following output: 

Please log off by 14:00 

Network temporarily down for diagnostics 

LINE_NAME (LN) 

Logical name(s) of the line or lines to receive the message. It also specifies 
the name of a TELNET Server. 

DEVICE JVAMB (DN) 

Logical name(s) of the terminal or terminals to receive the message. 

SERVICE JNAME (SN) 

Name of the service or services to which terminals must be connected if 
they are to receive the message. 
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Responses Message written. 



Remarks 



-WARNING- No terminal matched attributes, message not written. 

-FATAL- Message output process failed. 

NOTE 

A success response is returned even if no terminals are active, if no 
terminal interface program (TIP) is installed in the DI to which the 
terminal is connected, or if the terminal user has disabled output of 
operator messages. 



At an interactive terminal, the message begins on the next line following 
the current cursor position. If output from a working connection is ready 
for a terminal, the message is inserted in the output. If the terminal has 
multiple working connections, the message appears immediately, regardless 
of the connection currently in use. If the user disables output of operator 
messages, the messages sent to the terminal are discarded, and are not 
retained for display at a later time. 

Each message begins with the date and time from the DI to which the 
terminal is connected. A message appears in the following format, where 
the message text may be one or more lines of text. 



yy/mm/dd hh.mm.ss 
<message te> 



FROM NETWORK OPERATOR 



Messages are sent from terminal users to the network operator by the 
REQUEST_NETWORK .OPERATOR (REQNO) terminal user command 
described in this manual. 



Examples send_command c='wr1te_term1nal_message, . . 

m=("New communications configuration tomorrow 
until 10:00. ")',s=td11 



* * * * 



Network down 



Message written. 
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Commands 15 

This chapter contains descriptions of commands used in terminal definition procedures 
(TDPs) and terminal user procedures (TUPs). 

These commands can be executed only by executing a TDP or TUP containing the 
commands. These commands cannot be entered individually through the Network 
Operator Utility (NETOU) or by the terminal user. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 

See the CDCNET Terminal Interface manual for the complete set of TUP commands. 
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DEFINE .ACCESSIBLE .REMOTE .SYSTEM (DEFARS) 
Terminal Definition Procedure Command 

Purpose Defines a Network Transfer Facility (NTF) remote system that is 

accessible via the directly connected NTF remote system defined by the 
DEFINE .REMOTE .SYSTEM command described in this manual. This 
command may be executed only by inclusion in a TDP. 

Format DEFINE .ACCESSIBLE _REMOTE .SYSTEM 

ACCESSIBLE .REMOTE .SYSTEM .NAME = name 

LINEJtAME = name 

ACCESSIBLE JREMOTE _SYSTEM JTYPE = keyword value 
ROUTE JACK POSITION = 0.254 or keyword value 
AUTHORITY JLEVEL = keyword value 

Parameters ACCESSIBLE .REMOTE .SYSTEM .NAME (ARSN) 

Specifies the logical name of a remote system that is accessed through the 
directly connected remote system. 

LINE_NAME (LN) 

Specifies the logical name of the line connected to the directly connected 
remote system through which the accessible remote system is reached. If 
line name does not match the line name specified on the DEFINE .LINE 
command, (described in this manual) the DEFARS command is ignored. 
Default is the name of the activating line. 

ACCESSIBLE ^REMOTE _SYSTEM JTYPE (ARST) 

Specifies the type of accessible remote system (mainframe and/or operating 
system). The following keyword values are allowed for this parameter: 

NOS.VE 

NOS 

NOS.BE 

IBM 

DEC 

CYBER .205 

ETA 

CRAY 

USER 

Default is IBM. 

This parameter is ignored for NJE remote systems. NTF uses this 
information to determine the routeback information format to insert when 
sending jobs to the accessible remote system. Routeback is the mechanism 
by which NTF propagates file ownership, destination, and routing 
characteristics. 

ROUTE JBACK_POSITIGN (RBP) 

Specifies the position in the job after which routeback information is 
inserted by NTF. Specifying NONE indicates no routeback information is 
inserted. Specifying indicates routeback information is inserted as the 
first record of the job. This parameter is ignored for NJE remote systems. 
Defaults depend on the value of ACCESSIBLE .REMOTE .SYSTEM .TYPE, 
and are as follows: 
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ACCESSIBLE REMOTE 
SYSTEM JTYPE 



DEnNE^CCESSIBLE_REMOTEJ3YSTEM (DEPARS) 



Default Routeback 
Position 



NOS_VE 

NOS 

NOS_BE 

IBM 

DEC 

CYBER _205 

ETA 

CRAY 

USER 



3 
3 
3 
2 
2 
3 
2 
3 
NONE 



AUTHORITY JLEVEL (AL) 

Specifies the authority level assigned to the accessible remote system being 
defined. The following keyword values are allowed for this parameter: 

Keyword Value Description 



NET 



JOB 



NONE 



Specifies that remote system operators are allowed to 
modify the logical configuration of the NTF network, 
as well as status and control files on the local 
NOS/VE system. 

Specifies that remote system operators are allowed to 
status and control files on the local NOS/VE system. 

Specifies that there is no authority level (no 
authorization) at the remote system. 



Default is NONE. 

This parameter is used for NJE remote systems, and is ignored for HASP 
remote systems. 

Responses Accessible remote system <name> is defined. 

—ERROR— Directly connected remote system <name> may not be defined 
as an accessible remote system. 

-ERROR- A define _accessible_remote_system command may only be used 
by lines serviced by the NTF TIP. 

—ERROR— A define ..accessible _remote_system command may not be 
included in a Terminal Definition Procedure executed via a DO command. 

-ERROR— A define __remote_system command must precede the first 
define ..accessible _remote_system command in a Terminal Definition 
Procedure. 

—FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_access1ble_remote_system .. 

accessl ble_remote_system_name«NODE_C 
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DEFINE .BATCH _DE VICE (DEFBD) 
Terminal Definition Procedure Command 

Purpose Defines a batch device on a configured I/O station. Can be executed only 
by inclusion in a TDP. Some parameters do not apply to batch devices for 
exclusive NOS use, so NOS/VE and NOS formats are listed separately. 

Configuring a device as a batch device implies that the device's I/O is 
supported through Batch Transfer Protocol (BTP). This command allows a 
device to be connected through Batch Transfer Facility (BTF). To configure 
a device for connections through Virtual Terminal Protocol (VTP), use 
DEFINE .TERMINAL .DEVICE. Devices supported by the XPCTIP can be 
configured only by DEFINE .TERMINAL .DEVICE. 

For printers supported by NOS Printer Support Utility (PSU), some 
parameters are controlled by PSU rather than DEFINE .BATCH .DEVICE 
(see Remarks section). 

Format NOS/VE Format: 

DEFINE .BATCH .DEVICE 
DEVICE .NAME = name 

LINEJNAME = name 
CLUSTER ^ADDRESS = 0..255 
DEVICE ^ADDRESS = 0.255 
DEVICE JTYPE = keyword value 
BANNER JIIGHLIGHT JFIELD = keyword value 
BANNER _PAGE JCOUNT = 0..3 
CARRIAGE JCONTROL JSUPPORT = keyword value 
DEVICE .ALIAS _1 - name 
DEVICE ^ALIAS J2 = name 
DEVICE _ALIAS J3 = name 

EXTERNAL JCHARACTERISTICS _1 = string 1..6 
EXTERNAL JCHARACTERISTICS J2 = string 1..6 
EXTERNAL JCHARACTERISTICS _3 = string 1..6 
EXTERNAL JCHARACTERISTICS _4 = string 1..6 
FILE ..ACKNOWLEDGEMENT = boolean 
FORMS JC0DE_1 = string 1..6 
FORMS jCODEJt = string 1..6 
FORMS JCODEJ3 = string 1..6 
FORMS _CODEji = string 1..6 
MAXIMUM _FILE jSIZE = integer 
PAGEJLENGTH = 0..176 
PAGEJPIDTH = 0..255 
TERMINAL _MODEL = name 
TRANSMISSION J3L0CK JSIZE = 128..4095 
CODE J3ET = name or keyword value 
VFU JLOAD ^PROCEDURE = name 
VERTICAL JPRINTJDENSITY = keyword value 
FORMS JSIZE = string 1..4 
UNDEFINED _FE ^ACTION = keyword value 
UNSUPPORTED JFE JLCTION = keyword value 
VFU JLOAD JOPTION = keyword value 

CONTROL JCODE JREPLACEMENT = list 1..64, 1..2 range of 
<ccode> 
DATAJPARITY = keyword value 
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START = boolean 
TRAILER _PAGE = boolean 

Format NOS Format: 

DEFINE .BATCH .DE VICE 
DEVICE .NAME = name 

LINEJiAME = name 
CLUSTER ADDRESS = 0.255 
DEVICE ^ADDRESS = 0..255 
DEVICE JTYPE = keyword value 
CARRIAGE JCONTROL ^SUPPORT = keyword value 
EXTERNAL ^CHARACTERISTICS JL = string 1..6 
EXTERNAL ^CHARACTERISTICS _2 = string 1..6 
EXTERNAL ^CHARACTERISTICS _3 = string 1..6 
EXTERNAL ..CHARACTERISTICS _4 - string 1..6 
PAGE_LENGTH = 0..128 
PAGE_WWTH - 0.255 
TERMINAL ^MODEL = name 
TRANSMISSION _BLOCK _SIZE = 128..4095 
CODE JSET = name or keyword value 
VFU _LOAD ^.PROCEDURE = name 
VERTICAL _PRINT_PENSITY = keyword value 
FORMS „SIZE = string 1..4 
UNDEFINED _FE _ACTION = keyword value 
UNSUPPORTED _FE .ACTION = keyword value 
VFU^LOADJOPTION = keyword value 

CONTROL JCODE ^REPLACEMENT = list 1..64, 1.2 range of 
<ccode> 

DATAJPARITY = keyword value 
START = boolean 
TRAILER JAGE = boolean 

Parameters DEVICE .NAME (DN) 

Specifies the logical name of the batch device. 

For batch devices that connect to NOS Remote Batch Facility (RBF), device 
names must be of the form x...xn, where x...x is any string of one to six 
characters, excluding underscore, and n is a digit in the range of 1..7. The 
value of n is the device ordinal used by RBF to form the RBF logical 
device name (that is, LPn, CRn, PUn). 

If the DEVICE _NAMB parameter is longer than seven characters, or 
contains an underscore, the RBF terminal name is generated by using the 
first seven characters, or all the characters before the first underscore if it 
is one of the first seven characters. For example, LINE1 .PRINTER has a 
NOS RBF terminal name of LINE1 (RBF logical device name LP1, 
assuming device .type =printer), and READER2.LINE06 has a NOS RBF 
terminal name of READER2 (RBF logical device name CR2, assuming 
device _type = reader). 

If you need to identify which line is associated with an RBF terminal 
name (for example, the NOS UCLP accounting message), a unique batch 
DEVICE .NAME must be specified for each batch device for each line. 

For batch devices supported by Printer Support Utility (PSU), the same 
restrictions apply, except that the digit is not used for a device ordinal. 
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LINE^NAME (LN) 

Specifies the logical name of the line to which the device is connected. If a 
DEFBD command is part of a TDP executed by line activation (by a DEFL 
reference), LINE .NAME defaults to the name of the activating line. If a 
DEFBD command is part of a TDP executed by a DO command, LINE_ 
NAME defaults to the name of the terminal user's line. Only DEFBD ~ 
commands whose line names match or default to the activating line or 
terminal user's line are executed. 

CLUSTER JiDDRESS (CA) 

This parameter is used for BSC3270 and MODE4 TIPs. Specifies the 
cluster address to be used by the TIP for communication with the batch 
device. Default is 0. 

For the HASP TIP, only one cluster is allowed on each line so this 
parameter is not used. 

For the MODE4 TIP, the CLUSTER .ADDRESS must be in the range of 
70(16) through 7F(16) for Mode 4A and 20(16) through 7F(16) for Mode 4C 
clusters. Since the default is 0, this parameter must be specified for all 
MODE4 devices. 

For the BSC3270 TIP, the cluster address must be in the range of 
through 31. Default is 0. 

NOTE 



In the configuration sequence that is entered at the 3270 workstation, the 
cluster address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. 



DEVICE .ADDRESS (DA) 

This parameter is used for HASP, BSC3270 and MODE4 TIPs. Specifies 
the device address to be used by the TIP for communication with the batch 
device. Default is 0. 

For devices supported by the HASP TIP, the DEVICE .ADDRESS 
parameter is ignored if DEVICE _TYPE= CONSOLE, and need not be 
specified. Only one console is allowed per cluster or line. All other device 
types must have a device address ranging from 1 through 7, corresponding 
to the stream number of the HASP workstation device being configured. 
For the MODE4 TIP, the DEVICE .ADDRESS must be 61(16) for all Mode 
4A devices and in the range of 61(16) through 6F(16) for Mode 4C devices. 
Since the default is 0, this parameter must be specified for all MODE 4 
devices. 

For the BSC3270 TIP, the device address must be in the range of 
through 31. Default is 0. 

NOTE 



In the configuration sequence that is entered at the 3270 workstation, the 
device address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. 
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DEVICE JTYPE (DT) 

Specifies the type of batch device. The following device types are supported. 

READER (R) 
PRINTER (PR) 
PUNCH (PU) 
PLOTTER (PL) 

Default is PRINTER. 

The TIP must be able to support the specified device type; otherwise this 
command is rejected. For example, an error is reported if DEVICE JTYPE 
is anything other than PRINTER for the URI TIP. The following table 
shows the batch device types supported by each TIP: 

TIP Batch Device Types Supported 



ASYNC 


PRINTER 


BSC3270 


PRINTER 


HASP 


PRINTER, PLOTTER, READER, PUNCH 


MODE4 


READER, PRINTER 


NJEF 


None 


URI 


PRINTER 


XPC 


None 


NTF 


None 


SNA3270 


CONSOLE 


X.25 ASYNCTIP 


PRINTER 



BANNER _HIGHLIGHT_FIELD (BHF) 

Specifies which of the banner fields is to be given prominence for files 
output on this device. BANNER _HIGHLIGHT_FIELD is appropriate for 
PRINTER and PUNCH devices only. The following parameter values are 
supported. 

COMMENT_BANNER (CB) 
ROUTING_BANNER (RB) 
SITE_BANNER (SB) 
USER_FILE_NAME (UFN) 
USER_NAME (UN) 

Default is ROUTING .BANNER. 

The actual text in these banner highlight fields is defined by other 
commands. 
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On NOS/VE, the COMMENT_BANNER and ROUTING. BANNER text are 
defined by the NOS/VE user command CHANGE .JOB .ATTRIBUTES: 

CHANGE_JOB_ATTRIBUTES COMMENT_BANNER=<comment banner text> 
CHANGE_JOB_ATTRIBUTES ROUTING_BANNER=<rout1ng banner text> 

The SITE .BANNER text is initially defined by the CHANGE _JOB 
ATTRIBUTE .DEFAULTS command, (described in this manual) which can 
only be entered from the NOS/VE system console: 

CHANGE. JOB_ATTRIBUTE_DEFAULTS SITE_INFORMATION=s1te banner text 

After configuration, the banner highlight field can be changed by the 
CHANGE .BATCH .DEVICE .ATTRIBUTES subcommand in the NOS/VE 
OPERATE .STATION utility. 

BANNER _J>AGE JCOUNT (BPC) 

Specifies the number of copies of banner pages that this device is to 
include with files output on this device. BPC is appropriate for printer and 
punch devices only. If the banner page count is set to 0, no accounting 
information is sent to a printer following an output file unless the 
TRAILER .PAGE parameter is set to TRUE. Default is 1. 

In a future CDCNET release, this interdependence of BPC and TP will be 
removed; BPC will have no effect on whether or not accounting information 
is printed. 

CARRIAGE JCONTROL _SUPPORT (CCS) 

Specifies the types of carriage control actions that the device supports. CCS 
is appropriate for printer devices only. The following keyword values are 
allowed. 

PRE .PRINT (PRE) 
POST.PRINT (POST) 
BOTH (B) 

Default is POST.PRINT. 

This parameter is ignored by the Asynchronous and URI TIPs. For devices 
supported by the BSC3270 TIP, only PRE .PRINT is supported. 

DEVICE .ALIAS _1 (DAI) 

Specifies the first alternative name by which the device can be referenced. 
The same device alias name can be assigned to more than one device in 
an I/O station. 

DEVICE ^ALIAS _2 (DA2) 

Specifies the second alternative name by which the device can be 
referenced. The same device alias name can be assigned to more than one 
device in an I/O station. 

DEVICE .ALIAS .3 (DA3) 

Specifies the third alternative name by which the device can be referenced. 
The same device alias name can be assigned to more than one device in 
an I/O station. 
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EXTERNAL ^CHARACTERISTICS J. (EC1) 

Specifies the first external device characteristic string supported by this 
device. External characteristics may specify, for example, the train type of 
a printer device (such as A6 for uppercase and A9 for uppercase and 
lowercase ASCII); the name of a plotter or the plotter's manufacturer; or 
the default code set for a card reader (such as 026 or 029). For a 
PRINTER device, default for this parameter is NORMAL. For any other 
device type, default for this parameter is to define no external 
characteristics. For card reader -batch devices and for NOS batch devices, 
only the EXTERNAL .CHARACTERISTICS .1 parameter has meaning. 

NOS RBF supports the following printer train types: 

B6, A6, A9 
and the following plotter types: 

TR6, TR8 
NOS PSU supports the following printer train types: 

B6, A6, A9 (PSU treats B6 and A6 as the same.) 

For devices supported by the BSC3270 TIP, parameters EC1 through EC4 
do not apply. 

EXTERNAL JCHARACTERISTICS J2 (EC2) 

Specifies the second external device characteristic string supported by this 
device. See EXTERNAL .CHARACTERISTICS _1 for more information. 

EXTERNAL JCHARACTERISTICS J3 (EC3) 

Specifies the third external device characteristic string supported by this 
device. See EXTERNAL ..CHARACTERISTICS _1 for more information. 

EXTERNAL JCHARACTERISTICS _4 (EC4) 

Specifies the fourth external device characteristic string supported by this 
device. See EXTERNAL .CHARACTERISTICS _1 for more information. 

FILE ACKNOWLEDGEMENT (FA) 

Specifies whether or not file acknowledgement messages related to the 
device are to be displayed on the station operator's console. Default is the 
FILE .ACKNOWLEDGEMENT parameter value from the DEFIOS or 
DEFUIOS command for the I/O station to which the device belongs. If the 
value for the DEFIOS or DEFUIOS FILE .ACKNOWLEDGEMENT 
parameter is YES, file acknowledgement may not be set to NO for 
individual devices for that I/O station. 

FORMS JCODEJL (FC1) 

Specifies the first forms code string supported by the device. FORMS. 
CODE.l is appropriate only for PRINTER device types. Forms codes are 
used to select the files that may be printed on the device. Default is 
NORMAL. This parameter and other FORMS .CODE parameters are not 
used for NOS batch devices. 

FORMS _CODE_2 (FC2) 

Specifies the second forms code string supported by the device. FORMS. 
CODE .2 is appropriate only for PRINTER device types. Forms codes are 
used to select the files that may be printed on the device. 
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FORMS JC0DEJ3 (FC3) 

Specifies the third forms code string supported by the device. FORMS 
CODE.3 is appropriate only for PRINTER device types. Forms codes are 
used to select the files that may be printed on the device. 

FORMS _CODE_4 (FC4) 

Specifies the fourth forms code string supported by the device. FORMS 
CODE__4 is appropriate only for PRINTER device types. Forms codes are 
used to select the files that may be printed on the device. 

MAXIMUM JFILE JSIZE (MFS) 

Specifies the maximum size in bytes of any file that may be output to the 
device. MAXIMUM _FILE_SIZE is appropriate only for PRINTER, 
PLOTTER, or PUNCH device types. If MFS is not specified, no file size 
limit is defined. 

PAGE_£ENGTH (PL) 

Specifies the number of output lines that constitute a page for this device. 
This parameter has been replaced by the FORMS_SIZE parameter. For 
compatibility, this parameter is allowed on the DEFINE _BATCH_DEVICE 
command, but is ignored. 

PAGEJMDTH (PW) 

Specifies the number of columns that constitute a line for this device. 
PAGE .WIDTH is appropriate for PRINTER, PUNCH, and PLOTTER 
device types. If a value of is specified, and a batch transparent output 
file is sent to a HASP device, the PW value is interpreted as infinite. 

Default for PRINTER devices is 136 columns. Default for PUNCH or 
PLOTTER device types is 80 columns. 

TERMINAL _MODEL (TM) 

Specifies a 1- to 31-character terminal model name for the device. For 
READER, PUNCH, and PLOTTER device types, TERMINAL .MODEL is 
informational only, and may be set to any user- defined model name. For 
PRINTER devices, TERMINAL .MODEL defines the printer attributes 
supported by the printer. The following default values are defined for the 
TIPs supported by CDCNET. 



TIP Default Printer Terminal Model 

ASYNC CDC_537V 

HASP CDC_CYBER18 

URI CDC.585V 

MODE4 M4IMP 

X.25 ASYNCTIP CDC.537V 
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Other Control Data-supplied values for printers that you may specify for 
this parameter include the following: 

Value Description 

CDC_533V_536V Control Data 533 or 536 printer with VFU load 

image. 

ASYNC_ Asynchronous printer without VFU load image. 

PRINTER. 

WITHOUT_VFU 

M4NIMP Mode 4 nonimpact printer. 

POSTSCRIPT PostScript printer. 

XEROX _SPUR Xerox laser printer. 

These printer model names are not TKP-defined default values. To reference 
such printer models, you must specify the TM parameter on the DEFBD 
command. 

For more information on printer attributes, see the description of the 
DEFINE _PRINTER_MODEL .ATTRIBUTES command, in this manual. 

TRANSMISSION ^BLOCK _SIZE (TBS) 

Specifies the transmission block size used by the TIP for communication 
with the batch device. Use this parameter for output devices (such as 
consoles or printers). 

The value on this command overrides the TRANSMISSION _BLOCK_SIZE 
parameter on the DEFINE _LJNE command (described in this manual) for 
this device only. Default is the value specified on the DEFINE _LINE 
command described in this manual. This parameter is ignored by the URI 
TIP. 

CODE_SET (CS) 

Identifies the batch device's code set. You may specify a CDCNET-supplied 
code set or a site- defined code set. To specify a CDCNET-supplied code set, 
use one of the following keyword values: 

ASCII 

ASCII48 

ASCII64 

ASCII95 

ASCII128 

ASCII256 

EBCDIC 

Site- defined code sets have names selected by a site. 

When a name rather than a keyword value is specified, it is assumed that 
a site-defined translation table is used. An attempt is made to locate a 
load procedure with a procedure name matching the code set name. For 
input devices, the code set name, as specified by the load procedure name, 
has the suffix ©INPUT. Do not include this suffix should as part of the 
code set value for this parameter. 
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When one of the keyword values is specified, a Control Data-defined 
internal translation table is used. These tables are described in detail in 
the CDCNET Configuration Guide. 

The default, and supported, code sets depend upon the TIP supporting the 
batch device: 



TIP 

ASYNC and 

X.25 

Asynchronous 

BSC3270 

HASP 

URI 

MODE4 



Supported CDCNET-Supplied Code Sets 



ASCII128 (default), ASCII256 (if DATA _PARITY= NONE) 
ASCII, ASCH48, ASCII64, ASCII95 



EBCDIC (default) 

EBCDIC (default) 

ASCII95 (default), ASCII, ASCII48, ASCII64, ASCII128, 
ASCII256 

ASCH95 (default), ASCII64 



ASYNC, X.25 Asynchronous, BSC3270, HASP, and URI support site-defined 
translation tables for batch output. HASP supports a site-defined 
translation table for batch input. 

VFU _LOAD JPROCEDURE (VLP) 

Specifies the name of the procedure containing the default VFU load image 
for the batch device. If the value for the VFU_LOAD_OPTION is any 
value but NONE, default for VLP is the Control Data-supplied procedure 
CDC_VFU for user-defined terminal models. For other Control 
Data- defined models, the default is VFU ^.model _name. 

The VLP is executed when a printer initially becomes active. Although the 
resultant VFU load image is loaded into the printer every time the line is 
started after being stopped, the DEFINE _VFU_LOAD_IMAGE (DEFVLI) 
commands in the VLP are guaranteed to be reprocessed only when a 
CHANGE _BATCH_DEVICE .ATTRIBUTES (CHABDA) command 
specifying the VLP parameter is executed. Other changes and conditions 
during normal processing may also cause the DEFVLI commands to be 
reprocessed. 

VERTICAL _PRINT_PENSITY (VPD) 

Indicates the default vertical print density for the device and whether or 
not the density for the device can be changed by the TIP. The following 
values are allowed: 



Keyword Value 



Description 



SIX_ANY, EIGHT.ANY 



SLX_ONLY, EIGHT_ONLY 



The vertical print density can be changed 
to either six lines per inch or eight lines 
per inch. 

The vertical print density, cannot be 
changed. 
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Default for HASP and MODE4 TIPs is SIX_ONLY. Default for the URI, 
ASYNC, and X.25 Asynchronous TIPs is SIX .ANY. For terminal model 
POSTSCRIPT, VPD is forced to SIX.ONLY. For terminal models starting 
with 'POSTSCRIPT.', SIX_ONLY is the default. 

FORMS _SIZE (FS) 

A string value that represents the length, in inches, of the forms in the 
printer. Strings representing decimal numbers that are multiples of half 
inches from 0.5. to 31 inches are allowed. This parameter replaces the 
PAGE .LENGTH parameter. The forms size value is passed to the control 
facility, and is used, with the file-specified vertical print density, to select 
files for printing. Default is 11. 

FORMS _SIZE is automatically adjusted to account for margins used on 
page printers for batch devices specifying one of the following values for 
the TERMINAL .MODEL parameter: 

POSTSCRIPT 

POSTSCRIPT, (site defined name beginning with POSTSCRIPT.) 

XEROX_SPUR 

Specifically, the following adjustments are made for FORMS _SIZE 
parameter values specified on the DEFBD command: 

Specified Value Actual Value 



Less than 1.5 0.5 

Less than 12.0 and greater FORMS .SIZE - 1 
than 1.5 

More than 12.0 FORMS .SIZE - 2 

NOTE 

When printing files in horizontal orientation with the XEROX.SPUR 
printer model, if the FORMS.SIZE is greater than 11.0, the actual number 
of lines that print on a page may not be equal to FORMS .SIZE times 
vertical print density. 

If you specify a FORMS .SIZE parameter value of 10 on the DEFBD 
command, the value is not changed. This exception of handling FORMS. 
SIZE = 10 will be removed in a future CDCNET release. 
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UNDEFINED _FEJLCTION (UNDFA) 

Indicates the action the TIP should take with undefined format effectors. 
The following keyword values are allowed: 



Keyword Value 


Description 


PAS 


Print after spacing 


PBS 


Print before spacing 


DPL 


Discard print line 


Default is PAS. 





UNSUPPORTED J?E_ACTION (UNSEA) 

Indicates the action the TIP should take with format effectors defined but 
not supported by the device. The following keyword values are allowed: 



Keyword Value 


Description 


PAS 


Print after spacing 


PBS 


Print before spacing 


DPL 


Discard print line 


Default is DPL. 





VFU _£OAD jOPTION (VLO) 

Indicates the presence of a loadable vertical format unit (VPU) load image 
for the batch device, and any restrictions on changing the VFU. The 
following keyword values are allowed: 

Keyword Value Description 



NONE VFU load image not present or not loadable. 

INIT Specify VFU load procedure during configuration 

only; VFU load procedure cannot be changed by I/O 
station operator or user. 

OPER Default VFU load procedure can be changed by the 

I/O station operator. 

USER I/O station operator can change default VFU load 

procedure; users can change VFP for individual files. 

Default for batch devices supported by the ASYNC, URI, and X.25 
Asynchronous TIPs is USER. 

VLO must be NONE if SIX _LPI .SEQUENCE and EIGHT_LPI_ 
SEQUENCE are defined for the printer terminal model. 
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CONTROL JCODE ^REPLACEMENT (CCR) 

This parameter is supported by the ASYNC, X.25 Asynchronous, and URI 
TIPs only. It specifies a list of < control _code> and < replacement _code> 
pairs, that is, (< control _code>, < replacement _code>). 

The < control _code> identifies a control code or range of control codes 
that should not be transmitted to the device. The < replacement _code>, 
which is optional, identifies the code to be transmitted to the device in 
place of the control code or codes identified by < control _code>. If 
< replacement _code> is not specified, no code is transmitted in place of 
<control _code > . 

Allowed values for < control _code> are through 31 and 128 through 
159. Allowed values for < replacement __code> are through 255. 

This attribute is in effect for both transparent and nontransparent output 
received from the connected application. CCR processing of data not 
originating from the connection is done as follows: 



No CCR processing done. 
CCR processing done. 



NO CCR processing done. 



VFU data 

INITIALIZATION_PROCEDURE 

INITIAUZATION_SEQUENCE 

FILE_PREFIX_PROCEDURE 

FILE_PREFIX_SEQUENCE 

FILE_SUFFIX_SEQUENCE 

CHANNEL. 1_SEQUENCE .. 
CHANNEL_12_SEQUENCE 
SI NGLE.SPACE.SEQUENCE 
NO_SPACE_SEQUENCE 
FORM_FEED_SEQUENCE 

E I GHTJ.P I .SEQUENCE CCR processing is done when these 

SIX_LPI_SEQUENCE sequences are output prior to a file being 

printed. 

No CCR processing is done when these 
sequences are sent as a result of an S or 
T format effector within a print file. 

DATA _PARITY (DP) 

Specifies parity for data received and transmitted on this line. The 
following values are allowed for DATA .PARITY: 



Keyword Value 



Description 



ZERO 
MARK 

EVEN 

ODD 

NONE 



The parity bit is always zero. 

The parity bit is always 1. 

The parity bit is set so the sum of the parity and 
data bits is an even value. 

The parity bit is set so the sum of the parity and 
data bits is an odd value. 

The parity bit is considered a data bit. 
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Default is EVEN. 



This parameter is only meaningful for asynchronous and X.25 devices. For 
an asynchronous device to use an 8-bit code set, either Control 
Data-defined or site-defined, set data parity to NONE. 

START (S) 

Specifies whether or not the batch device should be initialized and started 
Default is TRUE; START. 

TRAILER JPAGE (TP) 

Specifies whether or not a trailer page should be generated for the device. 
Default is TRUE, generate the trailer page. 

Responses Batch device <name> defined. 

-ERROR- A DEFIOS, DEFUIOS or DEFNBS command must precede the 
first DEFBD command in a Terminal Definition Procedure. 

-ERROR- Batch device _name <name> is not unique within the I/O 
station. 

-ERROR- Line_name <name> does not match name of the terminal 
user's line. Line_name, if specified, must match the terminal user's line 
name when a Terminal Definition Procedure is executed via a DO 
command. 

-ERROR- <parameter_name> may not be specified for the given device 
type. 

-ERROR- File_acknowledgement may not be specified as NO, FALSE or 
OFF for the device while the device is assigned to an I/O station with 
file .acknowledgement specified as YES, TRUE, or ON. 

-ERROR- < parameter _name> value is not allowed. 

-ERROR- < parameter _name> keyword is not recognized. 

-ERROR- Cannot locate the specified printer terminal model. 

-ERROR- VFU_LOAD .OPTION must be NONE if SIX_LPI_ 
SEQUENCE and EIGHT.LPI .SEQUENCE are defined for the printer 
terminal model. 

-FATAL- Not enough memory currently exists for required table space. 
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Remarks 



Examples 



If a standalone printer is used on NOS, it is supported by the NOS Printer 
Support Utility (PSU). In this case, several printer attributes are specified 
by PSU commands. The values specified by PSU commands override values 
specified by corresponding parameters on the TDP's DEFBD command that 
defines the printer. 



Such attributes are: 
DEFBD Parameter 



PSU Command 



BANNER_PAGE .COUNT 

FORMS_CODE_n 

FORMS _SIZE 

VERTICAL _PRINT_ 
DENSITY 

NOTE 



BANNERS 
FORM 
PRSIZE 
PRSIZE 



Although the PSU BANNERS command overrides the BPC parameter 
regarding how many banner pages to generate, the BPC parameter has 
another use that is independent of the BANNERS command. In particular, 
if the BPC parameter is set to and if the TRAILER _PAGE parameter is 
not specified, no accounting message (such as "TRANSFER COMPLETE - 
nnnnnnn LINES PRINTED") is printed at the end of the file. In a future 
release of CDCNET, the BPC parameter will have no impact on whether 
or not the accounting message is printed. 



def 1 ne_batch_dev1 ce devl ce_name=pr 2 , devl ce_type«pr 1 nter , , 
dev 1 ce_address-3 



def 1ne_batch_dev1ce devl ce_name=prl, devl ce_type»pr Inter, 
forms_code_1«l Ined 
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DEFINE _BATCH ..STREAM (DEFBS) 
Terminal Definition Procedure Command 

Purpose Defines a Network Transfer Facility (NTF) batch stream associated with 
the directly connected NTF remote system defined by the DEFINE _ 
REMOTE _SYSTEM command described in this manual. Defining a~batch 
stream implies that I/O for the stream is supported through the Batch 
Transfer Protocol (BTP). This command may be executed only by inclusion 
in a TDP. 

Format DEFINE .BATCH _STRE AM 

STREAM .NAME = name 
STREAM _TYPE = keyword value 

UNEJtIAME = name 
STREAM JORDINAL = 1..7 
MAXIMUM _FILE _SJZE = integer 
TRANSMISSION JBLOCK SIZE = 400..4095 
PAGE_WWTH = 10..255 
TRANSPARENT JMODE = boolean 
SKJPJPUNCHJCOUNT = 0..9 
START = boolean 

Parameters STREAM _NAME (SN) 

Specifies the logical name of the batch stream. 

STREAM _TYPE (ST) 

Specifies the type of batch stream. The following keyword values are 
allowed: 

READER (RD) 

PRINTER (PR) 

PUNCH (PU) 

PLOTTER (PL) 

REMOTE .SYSTEM _INPUT (RSI) 

JOB .RECEIVER (JR) 

SYSOUT .RECEIVER (SR) 

JOB .TRANSMITTER (JT) 

SYSOUT.TRANSMITTER (ST) 

LINEJVAME (LN) 

Specifies the logical name of the line connected to the directly connected 
remote system. If the line name specified does not match the line name 
specified on the DEFINE .LINE command, the DEFBS command is 
ignored. Defaults to the name from the DEFINE .LINE command. 



15-18 CDCNET Commands 



60000414 C 



DEFINE_£ATCH J3TREAM (DEFBS) 



STREAM JORDINAL (SO) 

Specifies the stream ordinal. The stream ordinal uniquely identifies each 
transmit or receive stream. The NTF TIP supports up to seven receive 
streams for the following stream types: 

PRINTER 

PUNCH 

PLOTTER 

REMOTE .SYSTEM .INPUT 

JOB .RECEIVER (with SYSOUT_RECEIVER, up to combined total of 

eight) 

SYSOUT.RECEIVER 

The NTF TIP supports up to seven transmit streams for the following 
stream types: 

READER 

JOB .TRANSMITTER (with SYSOUT.TRANSMITTER, up to a 

combined total of eight) 

SYSOUT.TRANSMITTER 

For HASP remote systems, the PUNCH, PLOTTER, and REMOTE. 
SYSTEM .INPUT streams share the HASP punch stream. The stream 
ordinal assigned to these streams must be unique for the NTF TIP to 
determine which HASP punch stream is to be used for each PUNCH, 
PLOTTER, or REMOTE .SYSTEM .INPUT stream. Default is 1. 

MAXIMUM _FILE _SIZE (MFS) 

Specifies the maximum size, in bytes, of any file that may be transmitted 
to the stream. This parameter is for transmit-type streams, only. Default is 
no file size limit is defined. 

TRANSMISSION ^BLOCKJSIZE (TBS) 

Specifies the transmission block size to be used by the NTF TIP for 
communication with the remote system on the specified batch stream. For 
NJE remote systems, this parameter is ignored, since the transmission 
block size for all batch streams is negotiated during sign-on processing. 
For HASP remote systems, the transmission block size on the DEFINE. 
BATCH .STREAM command is compared to the transmission block size on 
the DEFINE .REMOTE .SYSTEM command, and the smaller of the two 
values is used. 

PAGE_WIDTH (PW) 

Specifies the number of columns that constitute a card image for the card 
reader stream to a HASP remote system. Default is 80 columns. 

TRANSPARENT _MODE (TM) 

Specifies whether data received on the HASP PRINTER, PUNCH, 
PLOTTER, and REMOTE .SYSTEM .INPUT batch streams is to be 
processed as transparent or nontransparent. Default is TRUE; the HASP 
receive stream processes data as transparent. 
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SKIPJ>UNCH_COUNT (SPC) 

This parameter is currently ignored, and will be implemented in a future 
release. Specifies the number of cards/lines at the beginning of a HASP 
PUNCH, PLOT, or REMOTE _SYSTEM_INPUT stream to be discarded. 
HASP remote systems typically precede data on punch streams with banner 
or lace cards. This parameter is ignored for NJE remote systems. The 
default values depend on the value of the REMOTE _SYSTEM_TYPE 
parameter on the DEFINE JREMOTE_SYSTEM command, and are as 
follows: 



REMOTE .SYSTEM JTYPE 

NOS_VE 

NOS 

NOS_BE 

IBM 

DEC 

USER 



Default Skip Punch Count 




2 
1 






START (S) 

Specifies that the batch stream is automatically started when the line is 
activated. This means that files may be transferred or 

received on this stream without NTF operator intervention. Default is 
TRUE. 

Responses Batch stream <name> is defined. 

—ERROR— A define _batch_stream command may only be used by lines 
serviced by the NTF TIP. 

—ERROR— A define _batch_stream command may not be included in a 
Terminal Definition Procedure executed via a DO command. 

—ERROR— A define _remote_system command must precede the first 
define _batch_stream command in a Terminal Definition Procedure. 

-ERROR- Batch stream .name <name> is not an NJE remote system 
protocol type stream. 

-ERROR- Batch stream _name <name> is not a HASP remote system 
protocol type stream. 

-ERROR- <parameter_name> may not be specified for the given stream 
type. 

-FATAL- Not enough memory currently exists for required table space. 

Examples def ine_batch„stream stream_name=SYS0UT_RECV1 i strean>_type-SR, so=1. 

def 1ne_batch_st ream stream_name'=LINE_PRINTER_2, st-PR, so»2. 
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DEFINE _I_0_STATION (DEFIOS) 
Terminal Definition Procedure Command 

Purpose Defines auto- configured private and public I/O stations on NOS and 
NOS/VE. It can also be used to define operator-configured public I/O 
stations on NOS and NOS/VE. Do not use this command to configure an 
operator- configured private I/O station; instead, use DEFINE _USER_I_0_ 
STATION or DEFINE _NP_BATCH .STATION. This command may only be 
executed by inclusion in a TDP. 

During connection to NOS systems, only the CONTROL .FACILITY, FILE_ 
ACKNOWLEDGEMENT, and P_M .ACTION parameters are used. 

Format DEFINE _1 .0 .STATION 

I .O .STATION .NAME = name 
CONTROL .FACILITY = name 

DEFAULT „JOB JDESTINATION = name 
STATION _USAGE = keyword value 
REQUIRED JOPERATORJDEVICE = name 
IjO_STATION_ALIAS = list 1..3 of name 
DESTINATION JUNAVAILABLE .ACTION = keyword value 
FILE JLCKNOWLEDGEMENT = boolean 
P_M_ACTION = keyword value 

Parameters I .O .STATION .NAME (IOSN) 

Specifies the logical name of the I/O station. For public and private 
auto-configured I/O stations, and operator- configured public I/O stations, 
this name is used to take control of I/O stations using the OPERATE. 
STATION (OPES) utility (OPES,STATION_NAME=station_name). In 
addition, for these I/O stations, you always use the value of this parameter 
for the STATION parameter on the PRINT .FILE command. 

CONTROL .FACILITY (CF) 

Specifies the name registered by the controlling Status and Control Facility 
Server (SCFS) for the I/O station. 

On NOS/VE, this name is defined by the CONTROL .FACILITY.NAME 
parameter on the ACTIVATE _SCFS NOS/VE command. The value of the 
CONTROL .FACILITY parameter on the DEFIOS command must match 
the value for the CONTROL _FACILITY_NAME parameter on the 
ACTIVATE .SCFS command. The default control facility name for 
ACTIVATE .SCFS is STATION .CONTROLLER.^ 

ACTIVATE _SCFS is documented in the NOS/VE Software Release Bulletin. 
This bulletin provides installation information. The ACTIVATE _SCFS 
command is described in the NOS/VE Network Management manual. 

NOTE 

If your site plans to have more than one control facility active in your 
network, be sure that the two control facilities are defined with different 
names. Do not use the default name for both control facilities. 



On NOS, this name is defined by the BATCH .TITLE parameter on the 
DEFINE _NP_TERMINAL_GW command. 
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If the I/O station connects to NOS/VE only, or to NOS and NOS/VE, the 
CONTROL .FACILITY parameter must match the name of a NOS/VE 
control facility. If the CONTROL .FACILITY parameter is set to a NOS/VE 
control facility name and there is a required operator device, the I/O 
station operator may switch between NOS/VE and NOS. For standalone 
printers connected to NOS, the CONTROL .FACILITY parameter must be 
set to a batch gateway title. Such an I/O station cannot be switched 
between NOS/VE and NOS. 

DEFAULT _tfOB DESTINATION (DJD) 

Specifies the destination to which an input file is sent if no destination is 
specified on the ROUTE _JOB command for the file or if no ROUTE _JOB 
command is entered for the file. A job destination is a family name 
registered (in the format BTFS$family_name) by a NOS/VE host. The 
ROUTE _JOB command indicates the job destination for the file. If this 
parameter is omitted and no ROUTE _JOB destination is specified, the 
DESTINATION .UNAVAILABLE .ACTION is taken. 

STATION _USAGE (SU) 

Specifies the mode of use for the I/O station. The following keyword values 
are allowed: 

Keyword Value Description 



PUBLIC NOS/VE output can be routed to I/O station name. 

The origin of batch input for a public I/O station is 
the I/O station itself. 

PRIVATE Output is routed to station operator's user name. The 

origin of batch input for a private I/O station is the 
operator at the operator's console. If private usage is 
specified, a user must log in and request control of 
the I/O station before the batch devices can become 
operational. On NOS/VE, files are routed to a private 
I/O station by specifying the name of the Control 
Facility for the I/O station rather than the I/O station 
name on the PRINT.FILE command. 

Default is PUBLIC. 

REQUIRED .OPERATOR J)EVICE (ROD) 

Specifies the device name of the only console from which a user can 
control the I/O station. If a required operator device is not specified for an 
auto- configured I/O station, a user at any console may request control of 
the I/O station. For an operator- configured I/O station, the station entering 
the DO command is the required operator device if no required operator 
device is specified on this command. 

This parameter must be specified if the I/O station is to connect to NOS 
RBF. This parameter must not be specified if the I/O station is to connect 
to NOS PSU. 
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IJO JSTATION _ALIAS (IOSA) 

Specifies one to three alias names for a public I/O station. If aliases are 
defined for a station, files can be directed to the I/O station by the station 
name or by one of the alias names. The same alias can be used by more 
than one I/O station. In this case, a file directed to the common alias is 
output to the I/O station with the first available device appropriate for the 
file. If aliases are not specified, files can be routed to the I/O station name 
only. 

Aliases are invalid for private I/O stations. 

DESTINATION ^UNAVAILABLE .ACTION (DUA) 

Specifies the action the DI should take if the job destination for a job is 
unavailable. The following keyword values are allowed: 

Keyword Value Description 

DROP The job is read and discarded and the reading of 

subsequent jobs continues if the destination is 
unavailable. 



STOP 



Default is STOP. 



The input device for the job is stopped and no more 
jobs are read from the device until the destination 
becomes available or until the operator drops the job 
by entering a command. 



FILE ^ACKNOWLEDGEMENT (FA) 

Specifies whether or not the I/O station operator is to receive 
acknowledgement messages at the console for each file received. Default is 
NO, no acknowledgement. 

PJdjLCTION (PMA) 

Specifies how TIPs supporting the print devices for the I/O station should 
process print lines containing PM (printer message) as the first two 
characters in the line. The following keyword values are allowed: 

Keyword Value Description _^^_____ 



DISPLAY 



PRINT 
DISCARD 

Default is PRINT. 



The line is displayed to the station operator as a 
printer message. A displayed printer message causes 
the device assigned to the print file to stop until the 
operator acknowledges the message by entering a 
START_BATCH_DEVICE command on NOS/VE or a 
GO command on NOS. If no operator is controlling the 
I/O station, output of a print file terminates when a 
printer message is detected. The print file is held 
until the operator explicitly selects it to print. 

The line is printed using the "P" format effector. 

The print line containing the printer message is 
discarded. 
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Responses 10 station <name> defined. 

-ERROR- 10 .STATION _NAME <name> already defined as an I/O 
station or remote system. Station may not be redefined in a Terminal 
Definition Procedure executed via a DO command. 

-ERROR- STATION .USAGE must be public for a DEFINE .1.0. 
STATION definition in a Terminal Definition Procedure executed via a DO 
command. 

-ERROR- I _0 .STATION _ALIAS names may not be specified for private 
10 stations. 

—ERROR— <parameter_name> keyword is not recognized. 

-ERROR- DEFINE_I_0 .STATION, DEFINE _USER_I_0 .STATION or 
DEFINE .NP.BATCH .STATION commands may not intermixed in the 
same Terminal Definition Procedure. 

-FATAL- Unable to start task < entry .point .name >. 
< Reason required task cannot be started > 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples The following example defines a public I/O station named Stationl. 

Stationl is to be controlled by control facility SCFS109. Acknowledgement 
messages are printed at the I/O station control console when files are 
received at the I/O station. Printer messages are to be printed. Aliases for 
the I/O station are REM1 and ENGBLDG. 

def 1ne_1_o_stat1on 1_o_stat1on_name=stat lonl , . . 
control_faclllty*scfsl09,statlon_usage=publlc. . . 
f 1 le_acknoi»ledgement=yes,p_m_act 1on=di splay, . . 
1 _o_st at 1 on_a 1 1 as= ( r em 1 , engb 1 dg ) 
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DEFINE JtfPJBATCH _STATION (DEFNBS) (NOS Only) 
Terminal Definition Procedure Command 

Purpose Defines an I/O station to be used only with NOS systems running the 

Remote Batch Facility (RBF). This command is used for operator-configured 
private I/O stations only. It can only be executed by inclusion in a TDP 
that is executed by a DO command. You cannot use this command in a 
TDP that is specified on a DEFINE _LINE command. The control facility 
for the NP (Network Products) batch station is the NOS application (RBF 
or PSU) that supports the station. 

Format DEFINE _NP_BATCH .STATION 

Parameters None. 

Responses 10 station <name> defined. 

-ERROR- Only one DEFNBS defined I/O station may be defined in a 
Terminal Definition Procedure executed via a DO command. 

-ERROR- DEFINE_I_0_STATION, DEFINE _USER_I_0 JSTATION or 
DEFINE _NP_BATCH_STATION commands may not be intermixed in the 
same Terminal Definition Procedure. 

—FATAL- Unable to start task < entry _point_name>. < Reason required 
task cannot be started > 

-FATAL— Not enough memory is currently available for required table 
space. 

Remarks DEFINE _NPJBATCH .STATION generates a name for the I/O station 
using a combination of the following values: 

The string $IOSTATION_. 

The last six hexadecimal digits of the DFs system ID. 

A four-digit decimal number in the range of 0000 through 9999. The DI 
software assigns this number consecutively for each $IOSTATION 
specification encountered. The first number assigned is 0000 (0000 
follows 9999 thereafter). 

For example, an I/O station connected to a DI with system ID of 
0800251FE029 that has last assigned number 1234 is named 
$IOSTATION _1FE029 _1235. 

Examples def1ne_np_batch_stat1on 
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DEFINE ..REMOTE _SYSTEM (DEFRS) 
Terminal Definition Procedure Command 

Purpose Defines a directly connected Network Transfer Facility (NTP) remote 

system. This command may only be executed by inclusion in a TDP. 

Format DEFINE _REMOTE .SYSTEM 

REMOTE .SYSTEM .NAME = name 

LOCAL .SYSTEM .NAME s name 

CONTROL .FACILITY = name 

DEFAULT. JOB .DESTINATION = name 

DEFAULT.FILE .DESTINATION = name 

LOGICAL .LINE .NUMBER = 1..999 

REMOTE .SYSTEM .PROTOCOL = keyword value 

REMOTE _SYSTEM_TYPE = keyword value 

ROUTE _PACK_POSITION = 0..254 or keyword value 

LINE_NAME = name 

TERMINAL JUSER PROCEDURE = name 

AUTHORITY _LEVEL = keyword value 

POSITIVE .ACKNOWLEDGE = keyword value 

WAIT_AJSIT = keyword value 

INACTIVITY JTIMER = 1..600 or INFINITE 

RECEIVE _PASSWORD = string 1..8 

TRANSMIT JPASSWORD = string 1..8 

TRANSMISSION _BLOCK _SIZE = 400..4095 

REMOTE IDENTIFIER = string 1..3 

SIGNON = string 1..80 

Parameters REMOTE .SYSTEM .NAME (RSN) 

Specifies the logical name of the directly connected remote system. 

LOCAL .SYSTEM .NAME (LSN) 

■% Specifies the logical name used by NJE remote systems to reference the 

DI. This name is used in sign- on processing and for remote operator 
commands. This parameter is required for NJE remote systems, but is 
ignored for HASP remote systems. 

CONTROL .FACILITY (CF) 

Specifies the name of the Status and Control Facility Server (SCFS) which 
is to be the control facility for the remote system. A title is registered by 
the control facility as "SCFS$NTF_control .facility". 

DEFAULT.JOB .DESTINATION (DJD) 

Specifies the destination to which all NJE received jobs are sent. For 
HASP remote systems, this parameter specifies the destination to which 
received jobs are sent if no destination is specified on the ROUTE .JOB 
command for the job. A job destination is a family name registered (as 
BTFS$family_name) by a CYBER 180 NOS/VE system. 

DEFAULT.FILE .DESTINATION (DFD) 

Specifies the destination to which all NJE received files are sent. For 
HASP remote systems, this parameter specifies the destination to which 
received files are sent if no destination is specified on the ROUTE .FILE 
command for the job. A file destination is a family name registered (as 
BTFS$family_name) by a CYBER 180 NOS/VE system. 
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LOGICAL _LINE .NUMBER (LLN) 

Specifies the logical line number assigned to the line between a DI and 
directly connected remote system. Each remote system definition (via 
DEFRS commands) must have a unique line number within a control 
facility; this allows remote operators to reference streams on specific lines. 

REMOTE .SYSTEM .PROTOCOL (RSP) 

Specifies the protocol used to communicate with the remote system. The 
following keyword values are allowed: 

NJE 
HASP 

Either NJE or HASP must be specified. 

REMOTE JSYSTEM JTYPE (RST) 

This parameter may be specified for both NJE and HASP remote systems. 
The following keyword values are allowed: 

NOS.VE 

NOS 

NOS.BE 

IBM 

DEC 

USER 

Default is IBM. 

If the remote system supports the HASP protocol, the REMOTE. 
SYSTEM _TYPE parameter value is used to determine the routeback 
information format to insert when sending jobs to the remote system. 
Routeback is the mechanism by which NTF propagates file ownership, 
destination, and routing characteristics. 

ROUTE JACK ^POSITION (RBP) 

Specifies the position in the job after which routeback information is 
inserted by NTF. Specifying NONE indicates no routeback information is 
inserted. Specifying indicates routeback information is inserted as the 
first record of the job. This parameter is ignored for NJE remote systems. 
Defaults depend on the value of the REMOTE _SYSTEM .TYPE parameter, 
and are as follows: 



REMOTE .SYSTEM .TYPE 



Default Routeback Position 



NOS_VE 

NOS 

NOS.BE 

IBM 

DEC 

USER 



3 
3 
3 
2 
2 
NONE 



UNEJ1AME (LN) 

Specifies the logical name of the line connected to the directly connected 
remote system. If the line name specified does not match the line name 
specified on the DEFINE .LINE command, the DEFRS command is 
ignored. Default is the name from the DEFINE .LINE command. 
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TERMINAL JJSER .PROCEDURE (TUP) 

This parameter is currently ignored, and will be implemented in a future 
release. Specifies the name of the terminal user procedure (TUP) associated 
with the remote system. The commands in the named TUP execute when 
the remote system is configured. Default is no TUP is executed. This 
parameter is for HASP remote systems, and is ignored for NJE remote 
systems. 

AUTHORITY ^LEVEL (AL) 

Specifies the authority level of the directly connected remote system 
operator. The following keyword values are allowed: 

Keyword Value Description 



NET Specifies that remote system operators are allowed 

to modify the logical configuration of the NTF 
network as well as status and control files on the 
local NOS/VE system. 

JOB Specifies that remote system operators are allowed 

to status and control files on the local NOS/VE 
system. 

NONE Specifies that there is no authority level. 

Default is NONE. 

This parameter is used for NJE remote systems, but is ignored for HASP 
remote systems. 

POSITIVE ^ACKNOWLEDGE (PA) 

Specifies what sequence should be sent to the remote system as a positive 
acknowledgement, if the NTF TIP has no data to transmit. The following 
keyword values are allowed for this parameter: 

ACK 

NULL 

Either the ACK sequence (DLE ACKO) or a NULL block (Function Control 
Sequence [FCS] block) may be sent as a positive acknowledgement. During 
NJE sign- on processing, ACK is the only valid response following receipt 
of ENQ from a remote system. The NTF TIP receives either ACK or 
NULL block as a positive response from another system. If the remote 
system sends NULL blocks in place of ACK, the TIP is able to better 
perform block sequence error checking. Default is ACK. 

WAIT_Ji_BIT(WAB) 

Specifies how the global wait-a-bit is cleared. The following keyword values 
are allowed for this parameter: 

Keyword Value Description 

ACK Receipt of an ACK clears the wait-a-bit. 

FCS The wait-a-bit is determined from the change FCS 

block. 

Default is ACK. 
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If NULL is specified for the POSITIVE ^ACKNOWLEDGE parameter, then 
FCS is the only value that may be specified for the WAIT_A_BIT 
parameter. The clearing of the wait-a-bit is determined from the change 
FCS block. 

INACTIVITY JTIMER (IT) 

Specifies the amount of time (in seconds) the DI waits for a response to a 
command sent to a HASP remote system on the console stream. If a 
response is not received in the specified amount of time, a message 
indicating no response is sent to the log file and the next available 
command is sent. The keyword INFINITE disables the timer and causes 
the DI to wait indefinitely for a response. Default is INFINITE. This 
parameter is for HASP remote systems, and is ignored for NJE remote 
systems. 

RECEIVE JPASSWORD (RP) 

Specifies the node password to be received from the NJE remote system 
during sign-on processing. Default is no password. This parameter is 
ignored for HASP remote systems. 

TRANSMIT PASSWORD (TP) 

Specifies the password to be sent to the HASP or NJE remote system 
during sign- on processing. For an NJE remote system, this value is the 
node password used during sign-on processing. Default is no password. 

TRANSMISSION _BLOCK_SIZE (TBS) 

Specifies the transmission block size to be used by the NTF TIP for initial 
communication with the remote system. The value on this command 
overrides the TBS parameter on the DEFINE _LINE command. 

REMOTE JDENTIFIER (RI) 

Specifies the remote identifier to be used on the "standard format" sign-on 
for a HASP remote system. Default for HASP remote systems is 1. This 
parameter is ignored for NJE remote systems. 

SIGNON (S) 

Allows the specification of a custom or "nonstandard format" sign- on for a 
HASP remote system. Default is a "standard format" sign- on sent using 
REMOTE ..IDENTIFIER and TRANSMIT_PASSWORD parameter values. 
This parameter is ignored for NJE remote systems. 
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Responses Remote System <name> is defined. 

-ERROR- A define _remote_system command may only be used by lines 
serviced by the NTF TIP. 

-ERROR- The controljfacility specified for remote system <name> does 
not match a previously defined remote system control jFacility. 

-ERROR- A define _remote_system command may not be included in a 
Terminal Definition Procedure executed via a DO command. 

—ERROR— Remote system name and logical line number are not unique for 
remote system <name>. 

—ERROR- Multiple define _remote_system commands may not be specified 
for the same line. 

-ERROR- Wait_a_bit may not be specified as ACK when positive _ 
acknowledge is NULL for remote system <name>. 

-FATAL- Unable to start task < entry _point_name>. < Reason required 
task cannot be started > 

—FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1 ne_remote_system .. 

remote_system_name=N0DE2, local_system_name=N0S_VE2, .. 
contro1_fadlity=SCFSl09, remote_system_protocol=NJE, .. 
loglca1_11ne_number=1, 1 i ne_name=LINE 1 , .. 
default_job_destinat1on=CLSH109, . . 
default.fi le_dest lnat1on=CLSHl09 
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DEFINE _TERMINAL_DEVICE (DEFTD) 
Terminal Definition Procedure Command 

Purpose Defines a terminal device on a configured line. This command executes 

when the communication line connected to the terminal device is activated. 
Except for the ASYNC TIP, Control Data-provided TIPs only support the 
definition of CONSOLE devices via the DEFINE .TERMINAL .DEVICE 
command. This command may be executed only by inclusion in a TDP. 

Configuring a device as a terminal device implies the I/O for that device is 
supported through the Virtual Terminal Protocol (VTP). To configure a 
device for connections through Batch Transfer Protocol (BTP), use 
DEFINE _BATCH .DEVICE. Devices supported by the XPCTD? can be 
configured only by DEFINE .TERMINAL .DEVICE. 

Format DEFINE .TERMINAL .DEVICE 

DEVICE JiAME = name 
LINE_NAME = name 
CLUSTER ^ADDRESS = 0.J255 
DEVICE JU)DRESS = 0..255 
DEVICE _TYPE = keyword value 
TERMINAL JJSER JPROCEDURE = name 
TRANSMISSION _BLOCKJ3IZE = 128.A095 
VALIDATE JUSERS = boolean 

Parameters DEVICE JSTAME (DN) 

Logical name of the terminal device. 

This parameter, when specified, is also used to generate a NOS terminal 
name if the terminal is connected to a NOS host. If you use this 
parameter to define NOS terminal names, make sure that each NOS 
terminal name is unique throughout the network. For more information, 
see the CDCNET Configuration Guide. The default value for the terminal 
device name is constructed using the following information: 

• $ (dollar sign). 

• DEVICE .TYPE parameter value from this command 
(default= CONSOLE). 

• The system ID of the DI to which the terminal device is connected. 
Only the last six digits of the 12-hexadecimal-digit system ID are used. 

• The LIM number to which the communication line supporting the 
terminal device is connected. This value is specified on the DEFINE. 
LINE command. 

• The port number to which the communication line supporting the 
terminal device is connected. This value is specified on the DEFINE. 
LINE command. 

• Cluster address for the terminal device (default =0). 

• Device address for the terminal device (default =0). 
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For example, given the following information and command/parameter 
values: 

system. Id ■ 080025109999 

define.Hne 11m=4 port =2 

def1ne_term1nal_dev1ce device_type»console c luster _address=00, . . 

termi nal _address=00 

the default device name would be $CONSOLE .109999 .4200000000. 
LINE_FAME (LN) 

Logical name of the line. This parameter is optional when the DEFTD 
command is part of a terminal definition procedure (TDP), since the TDP 
is associated with a specific line and is a parameter on the DEFINE _LINE 
command. If this parameter is specified on a DEFINE ..TERMINAL.. 
DEVICE command within a TDP, the DEFINE .TERMINAL _DE VICE 
command is ignored if it does not match the LINE_NAME parameter 
value on the DEFINE _LINE command. 

CLUSTER _JU)DRESS (CA) 

Specifies the cluster address to be used by the TD? for communication with 
the batch device. This parameter is used for BSC3270 and MODE4 TIPs. 
Default is 0. 

For the HASP TIP, only one cluster is allowed on each line so this 
parameter is not used. 

For the MODE4 TIP, the CLUSTER .ADDRESS must be in the range of 
70(16) through 7F(16) for Mode 4A and 20(16) through 7F(16) for Mode 4C 
clusters. Since the default is 0, this parameter must be specified for all 
MODE4 devices. 

For the BSC3270 TIP, the cluster address must be in the range of 
through 31. Default is 0. 

NOTE 



In the configuration sequence that is entered at the 3270 workstation, the 
cluster address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. 



DEVICE JVDDRESS (DA) 

Specifies the device address to be used by the TIP for communication with 
the console device. This parameter is used for HASP, BSC3270 and 
MODE4 TIPs. For devices supported by the HASP TIP, the DEVICE. 
ADDRESS parameter is ignored if the DEVICE _TYPE = CONSOLE, and 
need not be specified. Default is 0. 

For the MODE4 TIP, the DEVICE .ADDRESS must be 61(16) for all Mode 
4A devices and in the range of 61(16) through 6F(16) for Mode 4C devices. 
Since the default is 0, this parameter must be specified for all MODE 4 
devices. 

For TIPS which support the X.PC protocol, if TDPs are used to configure 
the terminal devices (see DEFINE .LINE command in this manual), the 
TDP must not contain a DEFTD command with a nonzero device address. 
The X.PC protocol starts only when the device address is set to or defaults 
to zero. 
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For the BSC3270 TIP, the device address must be in the range of 
through 31. Default is 0. 



NOTE 



In the configuration sequence that is entered at the 3270 workstation, the 
device address must be specified using a different value from the one 
specified on this command. See the CDCNET Configuration Guide for more 
information. ' 



DEVICE JTYPE (DT) 

Specifies the type of terminal device. Defined parameters are: CONSOLE, 
READER, PRINTER, PUNCH, and PLOTTER. Default is CONSOLE. The 
TIP must be able to support the specified device type; otherwise the 
command is rejected. 

The following table shows the terminal (VTP) device types supported by 
each TIP: 

TIP Terminal (VTP) Device Types Supported 



ASYNC 


CONSOLE, PRINTER 


BSC3270 


CONSOLE 


NJEF 


None 


HASP 


CONSOLE 


MODE4 


CONSOLE 


NTF 


None 


NTF 


None 


SNA3270 


CONSOLE 



URI None 

TERMINAL JUSER PROCEDURE (TUP) 

Name of the terminal user procedure (TUP) to be executed for this device 
when the communication line supporting the device becomes active. A TUP 
may contain any terminal user command except ACTIVATE _AUTO_ 
RECOGNITION. This parameter allows you to predefine a user's terminal 
environment and have the environment automatically set up when the line 
becomes active. By specifying this parameter on this command, you 
override the TUP parameter value on the DEFINE _TIP or DEFINE _LINE 
command for this device. The default TUP is the one specified on the 
DEFINE JTIP or DEFINE _LINE command. 
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TRANSMISSION _flLOCK_SIZE (TBS) 

Specifies the transmission block size to be used by the TIP for initial 
communication with the terminal console device. The value on this 
command overrides the TRANSMISSION _BLOCK_SIZE parameter on the 
DEFINE _TIP or DEFINE JLINE command (described in this manual) for 
this device only. Default is the value specified on the DEFINE _LINE 
command (if TBS is specified on that command), or the DEFINE _TIP 
command (if TBS is not specified on the DEFINE JLINE command). 

VALIDATE JUSERS (VU) 

Specifies if users on this device are validated when user validation is 
enabled by the DEFINE _USER .VALIDATION command. If TRUE is 
specified, users are validated when validation is enabled. If FALSE is 
specified, users do not need to be validated. 

The value on this command overrides the VU parameter on the DEFINE _ 
LINE or DEFINE _TIP command on this device only. Default is the value 
specified on the DEFINE _LINE command or on the DEFINE _TIP 
command if VU is not specified on the DEFL command. 

Responses Terminal device < device _name> defined. 

-ERROR— Line name <line_name> not defined. 

-ERROR— Parameter line_name is required, but was omitted. 

-FATAL- Not enough memory currently exists for required table space. 
Examples def 1ne_term1nal .device dev1ce_name=trm_3, 1 1ne_name=l 1ne1 
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DEFINE _USER _I _0 ..STATION (DEFUIOS) 
Terminal Definition Procedure Command 

Purpose Defines an operator-configured private I/O station. This command is used 

for operator- configured private I/O stations only. It can be executed only by 
inclusion in a TDP that is executed by a DO command. You cannot use 
this command in a TDP that is specified on a DEFINE _LINE command. 
This command sets the required operator console for the station to the 
console entering the DO command. 

Format DEFINE .USER _I .O .STATION 

CONTROL .FACILITY = name 
DEFAULT.JOB .DESTINATION = name 

DESTINATION .UNAVAILABLE ^ACTION = keyword value 
FILE .ACKNOWLEDGEMENT = boolean 
P_M_ACTION = keyword value 

Parameters CONTROL .FACILITY (CF) 

Specifies the name registered by the controlling Status and Control Facility 
Server (SCFS) for the I/O station. This name is defined by the CONTROL _ 
FACILITY_NAME parameter on the ACTIVATE _SCFS NOS/VE command. 
The default control facility name for ACTIVATE _SCFS is STATION. 
CONTROLLER_l. ACTIVATE _SCFS is documented in the NOS/VE 
Software Release Bulletin. 

NOTE 

If your site plans to have more than one control facility active in your 
network, be sure that the two control facilities have different names. Do 
not use the default name for both control facilities. 



For operator-configured private I/O stations, you specify this Control 
Facility name for the following other commands: 

• On the OPERATE .STATION command. Specify the control facility 
name on the STATION _NAME parameter (OPERATE .STATION 
STATION .NAME = control .facility .name). 

• On the PRINT.FILE command. Specify the control facility name on the 
STATION parameter (PRINT .FILE STATION = control .facility .name). 

Since users sending files to a private I/O station must know the control 
facility name, you should distribute the control facility name to these 
users. 

DEFAULT.JOB .DESTINATION (DJD) 

Specifies the destination to which an input file is sent if no destination is 
specified on the ROUTE .JOB command for the file, or if no ROUTE .JOB 
command is entered for the file. A job destination is a family name 
registered (in the format BTFS$family_name) by a NOS/VE host. The 
ROUTE .JOB command indicates the job destination for the file. If this 
parameter is omitted and no ROUTE .JOB destination is specified, the 
DESTINATION .UNAVAILABLE .ACTION is taken. 
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DESTINATION .UNAVAILABLE .ACTION (DUA) 

Specifies the action the DI should take if the job destination for a job is 
unavailable. The following keyword values are allowed: 

Keyword Value Description 



DROP 



STOP 



The job is read and discarded and the reading of 
subsequent jobs continues if the destination is 
unavailable. 

The input device for the job is stopped and no more 
jobs are read from the device until the destination 
becomes available or until the operator drops the job 
by entering a command. 



Default is STOP. 



FILE .ACKNOWLEDGEMENT (FA) 

Specifies whether or not the I/O station operator is to receive 
acknowledgement messages at the console for each file received. Default is 
NO (no acknowledgement). 

PJMJLCTION (PMA) 

Specifies how TIPs supporting the print devices for the I/O station should 
process print lines containing PM (printer message) as the first two 
characters in the line. The following keyword values are allowed: 



Keyword Value 



DISPLAY 



PRINT 
DISCARD 
Default is PRINT. 



Description 



The line is displayed to the station operator as a 
printer message. A displayed printer message 
causes the device assigned to the print file to stop 
until the operator acknowledges the message by 
entering a START_BATCH _DEVICE command on 
NOS/VE and a GO command on NOS. If no 
operator is controlling the I/O station, output of a 
print file terminates when a printer message is 
detected. The print file is held until the operator 
explicitly selects it to print. 

The line is printed using the "p" format effector. 
The line is discarded. 
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Responses 10 station <name> defined. 

-ERROR- DEFINE .USER.I.0 .STATION definitions may not be 
included in a Terminal Definition Procedure addressed by a DEFINE _ 
LINE command. 

-ERROR- Only one DEFUIOS defined I/O station may be defined in a 
Terminal Definition Procedure. 

-ERROR- DEFINE_I_0 .STATION, DEFINE .USER.I.0 .STATION or 
DEFINE _NP_BATCH .STATION commands may not be intermixed in the 
same Terminal Definition Procedure. 

-FATAL- Unable to start task < entry .point .name >. < Reason required 
task cannot be started > 

-FATAL- Not enough memory is currently available for required table 
space. 

Remarks DEFINE .USER _I_0 .STATION also generates a name for the I/O station 
by the concatenation of the following: 

The string $IOSTATION.. 

The last six hexadecimal digits of the DI's system ID. 

A four-digit decimal number in the range of 0000 through 9999. The DI 
software assigns this number consecutively for each $IOSTATION 
specification encountered. The first number assigned is 0000 (0000 
follows 9999 thereafter). 

For example, an I/O station connected to a DI with a system ID of 
0800251FE029 that has last assigned number 1234 is named 
$IOSTATION .1FE029 .1235. 
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Examples The following command defines an operator- configured private I/O station 
that is controlled by control facility SCFS109 and is to print printer 
messages. 

def1ne_user_1_o_stat1on control_facil1ty»scfs109, . . 
P_m_act.1on=pr1nt 

This chapter contains descriptions of commands that can be used only in 
terminal user procedures (TUPs). Currently there are three such 
commands: The following commands (documented in the CDCNET Terminal 
Interface manual) can be used in TUPs, and can be executed from a 
terminal. 

ACTIVATE _X .PERSONAL .COMPUTER (ACTXPC) 
CHANGE .CONNECTION .ATTRIBUTES (CHACA) 
CHANGE .TERMINAL .ATTRIBUTES (CHATA) 
CHANGE .WORKING.CONNECTION (CHAWC) 
CREATE .CONNECTION (CREC) 
DEFINE .PASSTHROUGH .TITLES (DEFPT) 
DELETE .CONNECTION (DELC) 
DISPLAY.COMMAND .INFORMATION (DISCI) 
DISPLAY.COMMAND.LIST (DISCL) 
DISPLAY.CONNECTIONS (DISC) 
DISPLAY.CONNECTION .ATTRIBUTES (DISCA) 
DISPLAY.SERVICES (DISS) 
DISPLAY.TERMINAL .ATTRIBUTES (DISTA) 
DO 
REQUEST.NETWORK .OPERATOR (REQNO) 
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PUT_STRING (PUTS) 

Terminal User Procedure Command 



Purpose 



Format 



Parameters 



Remarks 



This command is used within a terminal user procedure (TUP) to send a 
message either to the terminal or to the connected service. You cannot 
issue this command interactively from your terminal. 

PUT_STRING 

STRING = string 

DESTINATION = keyword value 
DATA_MODE = keyword value 



STRING (S) 

Contains a message enclosed in single quotes. You can use 
characters in this message. 



as many as 80 



DESTINATION (D) 

Identifies where you are sending the message. The default is TERMINAL. 
The following keyword values are allowed: 



Keyword Value 



Description 



CONNECTION (C) 



Sends the message to your service via the working 
connection. 



TERMINAL (T) Sends the message to your terminal. 

DATA_MODE (DM) 

Specifies the input editing mode to be used when sending the message 
STRING. This parameter applies only for a DESTINATION of 
CONNECTION. The default is NORMAL. Transparent mode is useful for 
Passthrough and X.25 Terminal Gateway client connections to instruct the 
server to forward the data to the remote destination. 



Keyword Value 



Description 



NORMAL (N) 



VTP normal mode 



TRANSPARENT (T) VTP transparent mode 

• You cannot use the network command character (% by default) as the 
first character in a PUT_STRING command. However, the string value 
on PUT_STRING can contain the network command character. 

• When putting a string to the service (D=C), the network treats the 
message like other data input from the terminal by forwarding it to the 
connected service. 

• When putting a string to the terminal (D=T), the terminal displays the 
message in single-spaced format. 
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Examples Site administrators sometimes create a terminal user procedure for a 
specific automatic login sequence. From a TUP, the following PUT_ 
STRING command notifies the terminal user of what is happening: 

put .string string- 'Logging Into NOS/VE now. Please read .. 
your mall for scheduling news.' 

At the terminal, this string reads: 

Logging Into NOS/VE now. Please read your mall for scheduling news. 

Then, another PUT_STRING command sends the login information to the 
service. 

put.strlng str1ng=', usernam, password, velaf dest1nat1on=connect1on 

The following PUT_STRING command contains a DEFINE. 
PASSTHROUGH .TITLES command as a string. The DEFINE. 
PASSTHROUGH .TITLES command is used to register a title for the 
passthrough connection in the Interactive Passthrough Gateway. 

put.strlng str1ng='def ine_passthrough_t1tles t1tle=vepass' .. 
dest 1 nat 1 on=connect 1 on 

NOTE 



PUT.STRING commands can be used to log into a host and execute an 
initial set of commands. However, some hosts require a delay between the 
login statement and subsequent commands. For delay processing 
information, see the WAIT command later in this chapter. 
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SETJPAD .MESSAGE (SETPM) 
Terminal User Procedure Command 

Purpose Enables you to modify the CCITT and non-CCITT parameters of your 
public data network (PDN) or packet assembler/disassembler (PAD) 
concentrators. Converts the parameter numbers and values into an X.29 set 
PAD message and sends it to the PAD. Parameter reference numbers and 
values are restricted to the range of through 27. If non-CCITT 
parameters are included, they must follow CCITT parameters (when 
present), and the national marker must be included. This command may be 
executed only from a terminal user procedure (TUP). 

Format SET_PAD .MESSAGE 

VALUE = list 1..63 of list 2 of integer 

Parameters VALUE (V) 

A list of each PAD reference number followed by the value. 

To effectively support CDCNET attributes, the X.25 Asynchronous TIP 
depends on the proper functioning on the X.29 PAD and the settings of the 
PAD parameter reference numbers. Table 15-1 shows PAD parameters and 
their default settings. Assuming no changes to the default terminal and 
connection attributes, the X.25 Asynchronous TIP attempts to set the 
following PAD parameter reference numbers at initial connection time. Use 
the SET_PAD_MESSAGE command only if you want to change these 
settings. 

Remarks The X.25 Asynchronous TIP treats any CCITT X.3 reference number 

modified by the SETPM command as an X.3 reference number that cannot 
be mapped. Therefore, you should not use the SETPM command to set X.3 
parameters that are mapped to VTP attributes, because results might be 
unpredictable. 

Table 15-2 correlates PAD parameters to the corresponding CDCNET 
attributes. The X.25 Asynchronous TIP recomputes the PAD parameter 
values each time the CDCNET attributes are changed (by a terminal user, 
an application, or when terminating transparent mode). If the computed 
values are different (previously computed values are maintained for each 
virtual circuit) a set PAD message is sent to the PDN PAD with the 
updated values. 

Examples The following command causes a set PAD message to be sent to the PAD 
that changes CCITT reference 3 (data forwarding signal) to a 2 (CR). 
CCITT reference is CCITT- defined separator between Recommendation 
X.3 parameters and non-CCITT parameters. 33 is the Data Network 
Identification Code (DNIC) for TELENET. TELENET reference 63 (8-bit 
transparent) is set to (enabled). 

SETPM.value=((3,2),(0,33),(63,0)) 
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Table 15-1. Default PAD Parameter Settings 
Description 



PAD 

Reference 



4 



8 



10 



11 



Default Setting/Remarks 



PAD recall using a 
character 

Echo 



Decimal 1. Allows PAD recall using the 
DEL character. 

Decimal 1. Causes the PAD to echo 
received characters to the start-stop mode 
DTE. 



Selection of data forwarding Decimal 34. Causes forwarding of data by 



signal 

Selection of idle timer delay 

Ancillary device control 

Control of PAD service 
signals 

Selection of operation of 
PAD on receipt of break 
signal from the start-stop 
mode DTE 

Discard output 



Padding after carriage 
return (CR) 



Line folding 



Binary speed of start-stop 
mode DTE 



the PAD upon entry of the ELC (default 
is CR) and the EPC (default is LF). 

Decimal 0. No data forwarding on 
timeout. 

Decimal 0. No use of X-ON(DCl) and 
X-OFF(DC3). 

This reference number is never modified 
or referenced by the X.25 Asynchronous 
TIP. 

Decimal 21 (1+4+16). The PAD sends an 
interrupt packet to the packet mode DTE 
(1), sends an indication of break PAD 
message to the packet mode DTE (4), and 
discards output to the start-stop mode 
DTE (16) when a break signal is received. 

Decimal 0. Normal data delivery to the 
start-stop mode DTE. 

Decimal 0. The PAD never performs 
padding after a carriage return. 

Decimal 0. The PAD never performs line 
folding. 

This is a read-only parameter. It is never 
modified, and is referenced when 
computing FFD, CRD, and LFD NULs. 

(Continued) 
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Table 15-1. Default PAD Parameter Settings (Continued) 



PAD 
Reference 



121 



13 2 



141 



151 



161 



171 



181 



191 



2Ql 



211 



221 



Description 



Flow control of the PAD by 
the start-stop mode DTE 

Line feed insertion after 
carriage return 

Padding after line feed 



Editing 



Character delete 



Line delete 



Line display 

Editing PAD service signals 

Echo mask 

Parity treatment 

Page wait 



Default Setting/Remarks 



Decimal 0. No use of X-ON(DCl) and 
X-OFF(OFF). 

Decimal 4. The PAD inserts a line feed 
after echo of CR to start-stop mode DTE. 

Decimal 0. The PAD never performs 
padding after line feeds. 

Decimal 0. No use of editing in the data 
transfer state. 

Never modified or referenced by the X.25 
Asynchronous TIP. 

Never modified or referenced by the X.25 
Asynchronous TIP. 

Never modified or referenced by the X.25 
Asynchronous TIP. 

Never modified or referenced by the X.25 
Asynchronous TIP. 

Never modified or referenced by the X.25 
Asynchronous TIP. 

Never modified or referenced by the X.25 
Asynchronous TD?. 

Never modified or referenced by the X.25 
Asynchronous TIP. _____ 



1. These PAD parameter reference numbers provide additional user facilities which are 
not necessarily provided in all PADs. 

2. If the PAD returns an error PAD message in response to the setting of reference 13 
(line feed insertion after carriage return), the X.25 Asynchronous TIP performs the 
cursor positioning itself. If an error PAD message is received in response to a setting 
of reference 3 (selection of data forwarding signal), the TIP sets reference 3 to 126. 
Any other errors reported by the PAD are ignored, since all other initial parameter 
settings are mandated by CCITT Recommendation X.3. 
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Table 15-2. PAD Parameter/CDCNET Attribute Correlation 

Effect on Setting 



PAD 

Reference CDCNET Attribute^) 



IEM 



E 



AC / IEM / ELC/ EPP / 
EPC / TTM / TLM / TCM / 
TFC / TTC 



If the input editing mode (IEM) is 
transparent, reference 1 (PAD recall using 
a character) is set to 0. Otherwise, 
reference 1 is set to 1. 

If echoplex (E) is TRUE, reference 2 
(echo) is set to 1. Otherwise, it is set to 
0. 

If the input editing mode is normal, the 
setting for reference 3 is the aggregate 
forwarding signal determined by the 
attention character (AC), the end line 
character (ELC), and the end partial 
character (EPC), but only if end partial 
positioning (EPP) is selected. 

If the input editing mode is transparent, 
the setting for reference 3 is the 
aggregate forwarding signal based on the 
attention character (AC) and the type of 
transparent mode. 

If transparent timeout mode (TTM) is 
selected, reference 3 is set to 0, and 
reference 4 (selection of idle timer delay) 
to 8. 

If transparent length mode (TLM) is 
selected, reference 3 is set to 0, and 
reference 4 to 20. 

If transparent character mode (TCM) is 
selected and equal to forward (F), the 
transparent forwarding character(s) (TFC) 
are mapped to reference 3. 

If TCM is equal to terminate (T), the 
transparent terminating character(s) 
(TTC) are mapped to reference 3. 

If TCM is equal to forward terminate 
(FT), only the forwarding character (TFC) 
is mapped to reference 3. 

If no transparent mode is selected, 
reference 3 is set to and reference 4 to 
20. 



(Continued) 
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Table 15-2. PAD Parameter/CDCNET Attribute Correlation (Continued) 

PAD 

Reference CDCNET Attribute(s) Effect on Setting 

3 CDCNET defines the transparent 

forwarding and terminating characters 
(TFC/TTC) as 8-bit characters. Since 
CCITT has no provision for mapping 8-bit 
characters to reference 3, the X.25 
Asynchronous TD? does not attempt to 
map these characters to reference 3 or 
reference 4 if the higher order bit is set. 

4 IEM See description of the setting of reference 

3. If the TIP cannot map a CDCNET 
character (AC/ELC/EPC/TTC/TFC) to 
reference 3, reference 4 is set to 20. If 
the computed value for reference 3 is 
rejected by the PAD (unsupported value), 
reference 4 is also set to 20. 

5 CFC If character flow control (CFC) is TRUE, 

reference 5 (ancillary device control) is 
set to 1; otherwise, it is set to 0. 

12 CFC If character flow control (CFC) is TRUE, 

reference 5 is set to 1; otherwise, it is set 
to 0. 

13 IEM / E / ELC / ELP / If input editing mode OEM) is normal, 
EPC / EPP then: echoplex (E) is TRUE; the end line 

character (ELC) is a carriage return (CR); 
end line positioning (ELP) is line feed 
(LF); the end partial character (EPC) is a 
carriage return (CR); and the end partial 
positioning (EPP) is line feed (LF), then 
reference 13 (line feed insertion after 
carriage return) is set to 4. Otherwise, 
reference 13 is set to 0. 
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WAIT 

Terminal Definition Procedure or Terminal User Procedure 
Command 

Purpose Delays execution of the next command(s) in a procedure file. This command 
may originate only from a terminal user procedure or a terminal definition 
procedure. 

For example, you can use WAIT when sending PUT_STRING data to a 
host application that has timing constraints. After a PUT_STRING logs a 
user into RBF and the console has been logged in, RBF requests the batch 
devices. When the next PUT_STRING references a batch device, execution 
of the next command must be delayed for a few seconds, to ensure that the 
batch device was allocated to RBF. 

Format WAIT 

TIME = integer 1..100 
Parameters TIME (T) 

Specifies, in seconds, the time to delay processing of the following 
command in the procedure file. 

Responses None defined. 



Examples 



The following command sequence shows how to use the WAIT command 
with the PUT_STRING command for delay processing: 



put.string stMng=',HGC,XXXXXX,IAF'. . 

dest 1 nat ion=connect Ion 
wait t1me=5 "Allow time for LOGIN to complete, 
put.strlng str1ng='MAIL'. . 

dest 1 nat 1 on=connect 1 on 
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WAIT (WAIT) 

Terminal Definition Procedure or Terminal User Procedure 

Command 

Purpose Delays execution of the next command(s) in a procedure file. This command 
may originate only from a terminal user procedure or a terminal definition 
procedure. 

For example, you can use WAIT when sending PUT_STRING data to a 
host application that has timing constraints. After a PUT_STRING logs a 
user into RBF and the console has been logged in, RBF requests the batch 
devices. When the next PUT.. STRING references a batch device, execution 
of the next command must be delayed for a few seconds, to ensure that the 
batch device was allocated to RBF. 

Format WAIT 

TIME = integer 1..100 

Parameters TIME (T) 

Specifies, in seconds, the time to delay processing of the following 
command in the procedure file. 

Responses None defined. 

Examples The following command sequence shows how to use the WAIT command 
with the PUT_STRING command for delay processing: 

put.string str1ng=',HGC,XXXXXX,IAF'. . 

dest 1 nat i on=connect 1 on 
wait t1me=5 "Allow time for LOGIN to complete." 
put.string strlng*'MAIL'.. 

dest 1 nat 1 on=connect 1 on 
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DEFINE _CODE_SET_BASE (DEFCSB) 16-2 

DEFINE _CODE_SET_TRANSLATION (DEFCST) 16-3 

DEFINE _VFU_LOAD_IMAGE (DEFVLI) 16-4 

PUT__BATCH .SEQUENCE (PUTBS) 16-7 
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This chapter contains descriptions of commands that can only be used in load 
procedures. Command descriptions are organized alphbetically by full command name. 

Unless specified otherwise, all commands are valid in both NOS and NOS/VE 
operations environments. 
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DEFINE _CODE_SETJ3ASE (DEFCSB) 
Load Procedure Command 

Purpose Specifies the name of a CDCNET standard code set against which changes 
specified by the TRANSLATIONS parameter of the DEFINE _CODE_SET_ 
TRANSLATION command (described next) are to be applied. This command 
is optional and can occur only in a code set procedure. If used, it may only 
appear once and then only as the first command of the load procedure. 
When this command is not present in a code set procedure, the base code 
set used is ASCII256. 

Format DEFINE _CODE_SET_BASE 

CODE_SET = keyword value 

Parameters CODE JSET (CS) 

Specifies a CDCNET-supplied code set as the base against which the 
translations specified in the DEFCST commands are applied. The following 
keyword values are allowed: 

ASCII48 

ASCII64 

ASCII95 

ASCII128 

ASCII256 

EBCDIC 

Default is ASCII256. 
Responses Code set base defined. 

-ERROR- Command DEFINE _CODE_SET_BASE is not allowed in proc 
type <xxx>. 

—ERROR— DEFCSB is not the first command or it appears more than once 
in the load procedure. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_code_set_base . . 
code_set » EBCDIC 
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DEFINE _CODE _SET_TRANSLATION (DEFCST) 
Load Procedure Command 

Purpose Defines a site-specific code set. This command is only valid within a code 
set procedure. The name of the procedure containing the DEFCST 
commands is used as the name of the code set being defined. A code set 
procedure can contain multiple DEFCST commands, their cumulative effect 
being the definition of a site- defined code set. A code set procedure defines 
one and only one code set. 

Format DEFINE _CODE _SET_TRANSLATION or 

DEFINE _CODE _SET_TRANSLATIONS 

TRANSLATIONS = list 1..64, 2..2 of <ccode> 

Parameters TRANSLATIONS (T) 

Specifies a list of up to 64 individual code translation pairs. Each pair 
consists of a <code> and a < translation code>, that is, 
( < code > , < translation _code > ). 

For output devices, <code> specifies the network's code, and 
< translation _code> specifies the code that is to be sent to the device in 
place of the network's code. Network codes which do not appear in any 
individual code translation pair are translated according to the base code 
set when they appear in output received from network applications. 

For input devices, <code> specifies the device's code and < translation _ 
code> specifies the network code that is to be sent to the network 
application in place of the device's code. 

If a particular value appears as the <code> in more than one translation 
pair in one or more DEFCST commands in the same procedure, it is 
considered multiply defined. In this case, the last definition takes effect 
when the actual code set is constructed. 

Responses Code set translations defined. 

-ERROR- Command DEFINE _CODE_SET_TRANSLATION is not allowed 
in proc type <xxx>. 

-FATAL- Not enough memory is currently available for required table 
space. 

Examples def 1ne_code_set_trans1ations .. 

translations « (<4E(16),26(16)),(50(16),2B(16))) 
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DEFINE _VFU .LOAD _IMAGE (DEFVLI) 
Load Procedure Command 



Purpose 



Format 



Defines the format of Vertical Format Unit (VFU) load images. A series of 
these commands can be put into a procedure to define a single load image. 
This command can be specified only in a load procedure. 

The procedure name can be referenced by the VFU _LOAD .PROCEDURE 
(VLP) parameter in the DEFINE _BATCH .DEVICE (DEFBD) and 
CHANGE _BATCH .DEVICE .ATTRIBUTES (CHABDA) commands, and as 
a file attribute of an output file. CDCNET software concatenates the 
supplied procedure name with the string LOAD.PROCEDURE# and 
accesses the procedure as type LOAD .PROCEDURE. The procedure CDC. 
VFU is provided with the CDCNET software released by Control Data. 
CDC.VFU contains a load image suitable for each of the supported forms 
lengths of 8.5, 11, and 12 inches at print densities of both six and eight 
lines per inch (suitable for printers with a terminal model value of CDC 
585V). 

If you do not specify a default VFU load image for a printer that has a 
loadable VFU, the DI supporting the printer uses the Control 
Data-provided VFU load procedure (CDC.VFU) for user-defined terminal 
models. For Control Data-defined models, the default is VFU .model, 
name. A VFU load procedure may be specified as a file attribute on an 
individual file by a user to override the default VFU load procedure. 

See the DEFINE .BATCH .DEVICE command description for information 
on when DEFINE _VFU .LOAD .IMAGE commands are processed. 



DEFINE _VFU .LOAD IMAGE 

LINE .NUMBER = list 1..127 of 1. 
CHANNEL = list 1..12 of 1..12 



.255 



Parameters 



LINE .NUMBER or LINE .NUMBERS (LN) 

Specifies one or more lines of the paper form for which the channel 
numbers should be set. 

CHANNEL or CHANNELS (C) 

Specifies the channels that are set for the line. 

Responses VFU line/channel pair defined. 

-ERROR- Command DEFINE .VFU .LOAD JEMAGE is not allowed in 
proc type <xxx>. 
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Remarks The TIP software controlling a printer calculates page length as forms size 
times vertical print density. 

You must specify top-of-form (channel 1) in the first line of the VFU data. 
Lines not specified are filled in by the command processor with zeros, up 
to the page length specified by the file. 

For URI TIP-supported printers, and for CDC_537V, the following apply: 

• If the bottom- of-form channel number and the auto page-eject channel 
number defined for the printer (see the DEFINE JPRINTER_MODEL_ 
ATTRIBUTES command description earlier in this chapter) are not 
specified in the load procedure, then the bottom-of-form channel is 
provided at the line number with the value <page length minus 2>, 
and the auto page-eject channel is provided at the line after that. 

• If one of those channels is specified in the load procedure, the other is 
defined so that the auto page- eject channel is in the line following the 
bottom-of-form channel. 

For other printer models, the auto page- eject channel and the bottom- of 
form channel are set in the same line. 

If an operator or user changes FORMS _SIZE or VERTICAL _PRINT_ 
DENSITY batch device attributes (using the CHANGE _BATCH_DE VICE _ 
ATTRIBUTES command or the T or S format effectors), the bottom-of-form 
and auto page-eject channels are moved to accommodate the change in 
number of lines on the form. If the auto page-eject option is changed, the 
auto page- eject channel is removed or restored (depending on option 
selected) in the VFU load image. 

You may specify more lines in the VFU than the page length value, as 
determined by forms size times vertical print density. However, only 
channel information for page length number of lines is sent to the printer's 
loadable VFU. 

Top-of-form channel (channel 1), bottom-of-form channel, and auto 
page- eject channel may each be specified only once in a load procedure. 
Auto page- eject channel may not be defined for line number 1. 

Examples These examples of DEFINE _VFU_LOAD_IMAGE are from released VFU 
load procedure CDC_VFU, which defines printer control channels in the 
following lines: 

Channel 1 in first line 
Channel 2 in every 2 lines 
Channel 3 in every 3 lines 
Channel 4 in every 4 lines 
Channel 5 in every 5 lines 
Channel 6 in every 6 lines 
Channel 7 in every 7 lines 
Channel 9 in every 9 lines 
Channel 10 in every 10 lines 
Channel 11 in first line 



60000414 C 



Load Procedure Commands 16-5 



Load Procedure Commands 



def 1 ne_vf u_ 1 oacL 1 mage . . 
channel =1 .. 
Hne_number«=l 

def1ne_vfu_load_1mage .. 
channel =2 .. 

I1ne_number=(1.3,5,7,9,11,13,15.17,19,21.23.25,27,29,31,33,35... 
37,39,41,43,45,47,49,51,53,55,57,59,61,63,65,67,69,. 
71,73,75,77,79,81.83,85,87,89,91.93,95) 

def1ne_vfu_load_image .. 
channel =3 .. 

Hne_number=(1,4,7,10,13.16,19,22.25,28,31,34,37,40,43,46,49,.. 
52,55.58,6164,67,70.73.76,79,82,85.88,91,94) 
def 1 ne_vf u_ 1 oad_ 1 mage . . 
channel -4 .. 

11ne_number=(1,5,9,13.17,21,25,29.33,37.41,45,49,53.57... 
61,65,69,73,77,81,85,89,93.) 

def 1 ne_vf u_ 1 oad_ 1 mage . . 
channel -5 .. 

Hne_number=(1,6.11,16,21.26,31,36,41,46,51,56,61,66... 
71,76,86.91,96) 

def1ne_vfu_load_1mage .. 
channel =6 .. 

Hne_number=(1,7,13,19,25,31.37,43,49,55,61,67,73,79,85,91) 

def1ne_vfu_load_1mage .. 
channel -7 .. 

I1ne_number=(1,8,15.22,29,36,43.50,57,64,71.78,85,92) 

def1ne_vfu_load_1mage .. 
channel =9 .. 
11ne_number=(1,10,19,28,37,46,55,64,73,82.91) 

def 1 ne_vf u_ 1 oad_ 1 mage . . 
channel =10 .. 
I1ne_number=(1,11,21,31,41.51,61,71,81,91) 

define_vfu_load_lmage .. 
channel=11 .. 
11ne_number=1 
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PUT _BATCH .SEQUENCE (PUTBS) 
Load Procedure Command 

Purpose Specifies data that should be output to a batch device. For example, if this 
command appears in a file prefix procedure, it specifies data to be sent to 
a printer before each nontransparent file is printed. This command may be 
executed only from a load procedure. 

Format PUT.BATCH .SEQUENCE 

SEQUENCE = list 1..31 of string or <ccode> 

Parameters SEQUENCE (S) 

Specifies a sequence of control codes or characters of data to be sent to a 
batch output device. 

NOTE 

The following character strings have special significance for the 
POSTSCRIPT printer model and site- defined printer models starting with 
'POSTSCRIPT.'. They should not be used within data in START. 
POSTSCRIPT-FILE or in other FPPs, because they may have special uses 
for other printer models in a future release. 

$PW 

$FS 

Responses -ERROR- Command PUT_BATCH .SEQUENCE is not allowed in proc 
type <xxx>. 



Examples 



-ERROR- A sequence parameter must be of type ccode or string. 
put_batch_sequence sequence=(CR , LF , 'STRING1 ' , 0A( 16) ) 
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Commands 17 

GET_CDCNET_PROCEDURE (GETCP) (NOS/VE Only) 17-2 

REPLACE _CDCNET_PROCEDURE (REPCP) (NOS/VE Only) 17-3 

SET_VERSION_LEVEL (SETVL) (NOS/VE Only) 17-4 

GETCP (Get CDCNET Procedure) (NOS MDI Only) 17-5 

REPCP (Replace CDCNET Procedure) (NOS MDI Only) 17-7 

ATTCP (Attach Configuration File) (NOS MDI Only) 17-8 

DEFCF (Define Configuration File) (NOS MDI Only) 17-10 

REPCF (Replace Configuration File) (NOS MDI Only) 17-12 

SETVL (Set Version Level Procedure) (NOS MDI Only) 17-14 
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Commands 17 

This chapter describes commands that access CDCNET configuration procedures on 
NOS/VE and NOS hosts. Use these procedures after creating configuration procedures, 
and before/after editing configuration procedures. On NOS/VE, these procedures simplify 
file access. To make these procedures available NOS/VE, you must enter the following: 

$syst em. CDCNET. version. independent . command J Ibrary 

On NOS, these procedures access the Network Pile Manager Utility (NETFM) and 
Network Procedure Library Manager (NETPLM) to change the network directory and 
update configuration procedure libraries and files. 



60000414 C Configuration File Management Commands 17-1 



GET_CDCNET_PROCEDURE (GETCP) (NOS/VE Only) 



GET_CDCNET_PROCEDURE (GETCP) (NOS/VE Only) 
NETOU Command 

Purpose Gets a configuration file or procedure from a configuration procedure 
library in the $SYSTEM.CDCNET.SITE .CONTROLLED catalog. This 
command has the alias ATTACH .CONFIGURATION _FILE. 

Format GET_CDCNET_PROCEDURE or 

ATTACH ..CONFIGURATION _FILE 
FILE = file 

FILE .TYPE = keyword value or PROCEDURE _TYPE 
PROCEDURE .NAME = keyword value 
STATUS = status variable 

Parameters FILE (F) 

The name of the local file that receives the contents of the configuration 
file or procedure when it is attached. 

FILE .TYPE (FT) or PROCEDURE .TYPE (PT) 

Indicates the type of procedure file to be attached. The following keyword 
values are allowed: 

SYSTEM .CONFIGURATION (SC) 

TERMINAL _USER .PROCEDURE (TUP) 

TERMINAL .DEFINITION .PROCEDURE (TDP) 

LOAD .PROCEDURE (LP) (alias for VFU .LOAD .PROCEDURE) 

EXCEPTION .LIST (ELIST) or (EL) 

PROCEDURE .NAME (PN) 

The name of the procedure within the appropriate procedure library that is 
to be attached. This parameter is required for procedure types SYSTEM 
CONFIGURATION, TERMINAL .USER .PROCEDURE, TERMINAL. 
DEFINITION .PROCEDURE, and LOAD .PROCEDURE. It does not apply 
to and is not required for file type EXCEPTION .LIST. 

For DI system configuration procedures (procedure type SC), specify the 
last six digits of the DI's system ID, and include the radix (16) (see 
example). For procedure types TUP, TDP, and LP, specify the entire name 
of the TUP, TDP, or LP. 

By specifying the keyword value ALL (PN = ALL), all procedures from the 
specified library are written to the specified file. 

STATUS 

SCL status variable. See the NOS/VE System Usage manual for 
information on this parameter. 

Examples This example attaches the configuration procedure for a DI with a system 
ID of 080025300117 to a local file named $LOCAL.B: 

getcp Slocal.b sc 300117(16) 
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REPLACE.CDCNETJPROCEDURE (REPCP) (NOS/VE Only) 



REPLACE _CDCNET_PROCEDURE (REPCP) (NOS/VE Only) 
NETOU Command 

Purpose Replaces a configuration procedure or file in the appropriate procedure 
library in the $SYSTEM.CDCNET.SITE .CONTROLLED catalog. This 
command has the aliases DEFINE .CONFIGURATION _FILE (DEFCF) and 
REPLACE .CONFIGURATION _FILE (REPCF). 

Format REPLACE _CDCNET_PROCEDURE or 

DEFINE ..CONFIGURATION _FILE or 
REPLACE .CONFIGURATION FILE 

FILE = file 

FILE .TYPE = keyword value or PROCEDURE _TYPE 

STATUS = status variable 

Parameters FILE (F) 

The name of the local file that contains the configuration file or procedure 
to be placed in the procedure library. 

FILEJTYPE (FT) or PROCEDURE _TYPE (PT) 

Indicates the type of file or procedure library in the 

$CDCNET.SYSTEM.SITE .CONTROLLED catalog that is updated with the 
contents of the local file. The following keyword values are allowed: 

SYSTEM .CONFIGURATION (SC) 

TERMINAL.USER.PROCEDURE (TUP) 

TERMINAL .DEFINITION .PROCEDURE (TDP) 

LOAD .PROCEDURE (LP) (alias for VFU .LOAD .PROCEDURE [VLP]) 

EXCEPTION .LIST (ELIST) or (EL) 

STATUS 

SCL status variable. See the NOS/VE System Usage manual for 
information on this parameter. 

Examples In this example, the file $LOCAL.B that was used in the GET.CDCNET. 
PROCEDURE example has been edited. Now, the SC procedure library 
must be updated. The following command is used to update the SC 
procedure library: 

repcp $local.b sc 
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SET_VERS10N _&EVEL (SBTVL) (NOSWE Only) 



SET_VERSION_LEVEL (SETVL) (NOS/VE Only) 
NETOU Command 



Purpose 



Format 



Parameters 



Remarks 



Examples 



Changes the default version level of software to be loaded into each DI and 
the default version level of the three CDCNET host utilities (ANACD, 
MANCC, and NPA). 

SET.VERSION .LEVEL 

PROCESSING .OPTION = list of keywords 
VERSION s level 
STATUS = status variable 

PROCESSING .OPTION (PO) 

Specifies which defaults are being set. The following keywords can be 
specified: 



Keyword 



Description. 



UTILITIES (U) 



EXCEPTION _LIST 
(EL) 



ALL 



Sets the default version for the three host 
utilities. The file $SYSTEM.CDCNET. VERSION. 
INDEPENDENT.CDCNET.VERSION is updated. 

Sets the default version for software to be loaded 
into each DI. The file $SYSTEM.CDCNET.SITE_ 
CONTROLLED.EXCEPTION_LIST is updated. 

Sets the default version for both UTILITITES and 
EXCEPTION .LIST files. 



VERSION (V) 

A 4-digit hexadecimal version level. 

STATUS (S) 

SCL status variable. See the NOS/VE System Usage manual for 
information on this parameter. 

You must have ALL, CYCLE, and CONTROL privileges for the specific 
files or catalogs containing the files you wish to update. 

Do not use this command to update the exception list if you are managing 
your CDCNET configuration with NETCU. The NETCU configuration 
database is not updated by this command. 

When you update the exception list, the command searches for the string 
dv=ww(16). If this string is not in the file, the command does not update 
the exception list. 

SETVL does not change the level specified on any DEFINE .EXCEPTION. 
SYSTEM command. 

This example sets the default version for both UTILITITES and 
EXCEPTION .LIST files to 7305. 

setvl ,po-all ,v-7305 



17-4 CDCNET Commands 



60000414 C 



GETCP (Get CDCNET Procedure) (NOS MDI Only) 



GETCP (Get CDCNET Procedure) (NOS MDI Only) 
NETOU Command 

Purpose Gets the specified procedure from the appropriate CDCNET procedure 
library (SCLIB, TDPLIB, TUPLIB, or LPLIB), or gets the exception list 
using NETFM and writes the procedure or exception list in the specified 
file. 

Format BEGIN,GETCP,DCNPLIB,FILE,PT,PN,L7BfiAfiY 

Parameters FILE (F) 

Specifies the name of the local file that receives the contents of the 
configuration procedure when it is attached. 

PT 

Specifies the procedure type. Allowed values include: 

Value Description 



Exception list 

System configuration procedures 
Terminal definition procedures 
Terminal user procedures 
Load procedures 



EL 

SC 

TDP 

TUP 

LP 

PN 

Specifies the procedure name. The PN value relates to the PT value, as 
shown in the following table. 



PT 



PN Value 



EL 



SC 



TDP 



TUP 



LP 



ALL 



There is no variable portion for exception lists. Do not enter 
a value. 

The last six digits of the DI's system ID. GETCP provides 
the first characters (SYSTEM _080025) for you. 

The complete TDP name, which must match the name on 
the PROC statement in the TDP. 

The complete TUP name, which must match the name on 
the PROC statement in the TUP. 

The complete load procedure name, which must match the 
name on the PROC statement in the load procedure. 

Specifies that all procedures in a library are written to the 
file specified by the FILE parameter. 



LIBRARY 

Specifies the procedure library name. You need specify this parameter only 
to get a procedure in a library not listed in the CDCNET directory. This 
parameter specifies the NOS direct access permanent file on the current 
user name containing the procedure library. 
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GETCP (Get CDCNET Procedure) (NOS MDI Only) 



Remarks When using GETCP in line mode, if a procedure name contains special 

characters, particularly commercial at (@), you must bracket the procedure 
name by dollar signs ($). For example, procedure @PSUTUP is specified as 
follows: 

begin ,getcp,dcnpllb,uppsu,t up, $epsutup$ 

The dollar signs are not required when using GETCP in screen mode. 

Examples The- following example gets the system configuration procedure SYSTEM.. 
080025100021 from procedure library SCLIB, and copies it to local file 
C100021. Since the variable portion of a system configuration procedure is 
the last six digits of the system ID, 100021 is specified for the PN 
(procedure name) parameter. 

begin, get cp.dcnpl ib,c100021,sc, 100021 

The following example gets terminal definition procedure RBF_WORK_ 
STATION _1 from procedure library TDPLIB, and copies it to local file 
TPRBFW1. Since the variable portion of a terminal definition procedure is 
the entire procedure name, RBF_WORK .STATION _1 is specified for the 
PN (procedure name) parameter. 

begin, get cp.dcnpl 1b,tprbfw1,tdp,Pbf_work_station_1 



17-4 CDCNET Commands 



60000414 C 



REPCP (Replace CDCNET Procedure) (NOS MDI Only) 



REPCP (Replace CDCNET Procedure) (NOS MDI Only) 
NETOU Command 

Purpose Places the specified file in the appropriate CDCNET procedure library 
(ELIST, SCLIB, TDPLIB, TUPLIB, or LPLIB). 

Format BEGIN,REPCP,DCNPLIB,FILE,PT,LZBf2ARY 

Parameters FILE (F) 

Specifies the name of the local file containing the procedure(s) to be 
replaced. 

PT 

Specifies the procedure type. Allowed values include: 

Value Description 

EL Exception list 

SC System configuration procedures 

TDP Terminal definition procedures 

TUP Terminal user procedures 

LP Load procedures 

LIBRARY 

Specifies the procedure library name. You need specify this parameter only 
to replace a procedure in a library not listed in the CDCNET directory. 
This parameter specifies the NOS direct access permanent file on the 
current user name containing the procedure library. 

Examples The following example replaces the system configuration procedure in local 
file C100021 in procedure library SCLIB. 

begin,repcp,dcnp11b,c100021,sc 

The following example replaces the TUP in local file UPPSU, in procedure 
library TUPLIB. 

beg 1 n , r epcp , dcnp 1 1 b , uppsu , t up 

The following example replaces the TDP in local file TPRBFW1, in 
procedure library TDPLIB. 

begin. repcp,dcnp11b,tprbfw1,tdp 
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ATTCF (Attach Configuration File) (NOS MDI Only) 
NETOU Command 

Purpose Attaches the specified file from the network directory, and converts the file 
from ASCII88 character code set to ASCII 6/12. Use this procedure before 
you edit a configuration procedure or exception list, and before a MANCC 
USE_CONFIGURATION_FILE subcommand. 

Format BEGIN,ATTCF,DCNPLIB,LFN,PFN,TYPE,NETNAME 

Parameters LFN 

The local ASCII 6/12 file to receive a copy of the configuration procedure. 

PFN 

The ASCII88 permanent file to get, save, or replace. If lfn and pfn have 
the same value, enter an asterisk (*) for this parameter. 

TYPE 

Specifies the procedure type. Allowed values include: EL (exception list), 
SC (system configuration file), TDP (terminal definition procedure), TUP 
(terminal user procedure), and LP (load procedure). This parameter 
generates the fixed portion of the network file name (NFN) for the file, 
which is assigned to each file type as follows: 



Type 



Fixed Portion of NFN 



EL 

SC 

TDP 

TUP 

LP 



EXCEPTION _LIST 
CONFIGURATION#080025 
TERMINAL _PROCEDURE# 
USER _PROCEDURE# 
LOAD _PROCEDURE# 



The fixed portion of the NFN is combined with the variable portion of the 
file name (see NETNAME parameter) to generate a complete NFN. 
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ATTCP (Attach Configuration Pile) (NOS MDI Only) 



NETNAME 

Specifies the variable portion of the NPN. The netname value is combined 
with the fixed portion (see type parameter) to generate a complete NFN. 
The netname parameter relates to the type parameter as follows: 

Type Netname Value 

EL Not needed. Use value for DEFCF. 

SC Last six digits of the DI's system ID. 

TDP The TDP name, which must match the name on the PROC 

statement in the TDP. 

TUP The TUP name, which must match the name on the PROC 

statement in the TUP. 

LP The load procedure name, which must match the name on 

the PROC statement in the load procedure. 

Examples In this example, file cl 00022 is attached and converted from ASCII88 to 
ASCII 6/12. File cl 00021 receives a copy of the configuration procedure. 

begin, attcf.dcnpl lb, c100022,c100021 
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DEFCF (Define Configuration File) (NOS MDI Only) 
NETOU Command 

Purpose Defines a configuration procedure or file in the network directory for the 
first time. DEFCF converts the specified file to ASCII88 character code set 
from ASCII #12, and saves the converted file. DEFCF also creates an 
entry in the CDCNET file directory. Use this procedure after you have 
created a CDCNET configuration procedure or have used the MANCC 
CREATE .CONFIGURATION _FILE (CRECF) subcommand. 

Format BEGIN,DEFCF,DCNPLIB,LFN,PFN,TYPE,NETNAME 

Parameters LFN 

The local ASCII 6/12 file to receive a copy of the configuration procedure. 

PFN 

The ASCII88 permanent file to get, save, or replace. If lfn and pfn have 
the same value, enter an asterisk (*) for this parameter. 

TYPE 

Specifies the procedure type. Allowed values include: EL (exception list), 
SC (system configuration file), TDP (terminal definition procedure), TUP 
(terminal user procedure), and LP (load procedure). This parameter 
generates the fixed portion of the network file name (NFN) for the file, 
which is assigned to each file type as follows: 



Type 



Fixed Portion of NFN 



EL 

SC 

TDP 

TUP 

LP 



EXCEPTION _LIST 
CONFIGURATION#080025 
TERMINAL _PROCEDURE# 
USER _PROCEDURE# 
LOAD _PROCEDURE# 



The fixed portion of the NFN is combined with the variable portion of the 
file name (see NETNAME parameter) to generate a complete NFN. 
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DEFCF (Define Configuration File) (NOS MDI Only) 



NETNAME 

Specifies the variable portion of the NFN. The netname value is combined 
with the fixed portion (see type parameter) to generate a complete NFN. 
The netname parameter relates to the type parameter as follows: 

Type Netname Value 

EL Not needed. Use value for DEFCF. 

SC Last six digits of the DI's system ID. 

TDP The TDP name, which must match the name on the PROC 

statement in the TDP. 

TUP The TUP name, which must match the name on the PROC 

statement in the TUP. 

LP The load procedure name, which must match the name on 

the PROC statement in the load procedure. 

Examples In this example, file clOOOOO is converted from ASCII 6/12 to ASCII88 and 
placed in file clOOOOl. The configuration procedure being defined is an SC 
(system configuration file). 

bef in, defcf F dcnplib,c100001,c100000,sc. 080025300011 
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REPCF (Replace Configuration File) (NOS MDI Only) 
NETOU Command 

Purpose Replaces the existing configuration procedure or file (same network file 

name and permanent file name) in the network directory. REPCF converts 
the specified file to ASCII88 character code set from ASCII 6/12, replaces 
the file in the NOS permanent file catalog, and updates the directory entry 
for the file in the CDCNET directory file. Use this procedure after you 
have edited a configuration procedure using a file editor or the MANCC 
EDIT_CONFIGURATION_FILE (EDICF) subcommand. 

Format BEGIN,REPCF t DCNPLIB,LFN,PFN,TYPE,NETNAME 

Parameters LFN 

Specifies the local ASCII 6/12 file to receive a copy of the configuration 
procedure. 

PFN 

Specifies the ASCII88 permanent file to get, save, or replace. If lfn and pfn 
have the same value, enter an asterisk (*) for this parameter. 

TYPE 

Specifies the procedure type. Allowed values include: EL (exception list), 
SC (system configuration file), TDP (terminal definition procedure), TUP 
(terminal user procedure), and LP (load procedure). This parameter 
generates the fixed portion of the network file name (NFN) for the file, 
which is assigned to each file type as follows: 



Type 



Fixed Portion of NFN 



EL 

SC 

TDP 

TUP 

LP 



EXCEPTION _LIST 
CONFIGURATION#080025 
TERMINAL .PROCEDURE* 
USER_PROCEDURE# 
LOAD .PROCEDURE* 



The fixed portion of the NFN is combined with the variable portion of the 
file name (see NETNAME parameter) to generate a complete NFN. 
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REPCF (Replace Configuration File) (NOS MDI Only) 



Examples 



NETNAME 

Specifies the variable portion of the NFN. The netname value is combined 
with the fixed portion (see type parameter) to generate a complete NFN. 
The netname parameter relates to the type parameter as follows: 



Type 



Netname Value 



EL 
SC 
TDP 

TUP 

LP 

CAUTION 



Not needed. Use value for DEFCF. 

Last six digits of the DI's system ID. 

The TDP name, which must match the name on the PROC 
statement in the TDP. 

The TUP name, which must match the name on the PROC 
statement in the TUP. 

The load procedure name, which must match the name on 
the PROC statement in the load procedure. 



These procedures display NETFM output as they access the CDCNET 
network directory file, NETDIR. Always check this output to ensure that 
the procedure completed successfully, particularly after the DEFCF and 
REPCF procedures. 

These procedures are in file DCNPLIB. If you need to display the ATTCF, 
DEFCF, and REPCF procedures themselves, Control Data recommends that 
you do not use Full Screen Editor (FSE) to view them. Changes may occur 
to files that contain the @ character. 

In this example, the existing configuration file ell 11 11 is converted from 
ASCII 6/12 to ASCII88 and returned to the network directory. Local file 
cl21212 receives a copy of the configuration file. 

begin, repcf ,dcnpl1b.c121212,cl 11 111 



60000414 C 



Configuration File Management Commands 17-13 



SETVL (Set Version Level Procedure) (NOS MDI Only) 



SETVL (Set Version Level Procedure) (NOS MDI Only) 
NETOU Command 



Purpose 



When a new version of Batch Corrective Update (BCU) for CDCNET is 
installed, the version level changes. The SETVL procedure updates the 
version level. 

The version level is included in all released CDCNET software files except 
site- controlled configuration files. Version levels in the file names allow 
multiple versions of CDCNET to reside together on disk under one user 
name. 

NOTE 

If you installed CDCNET for MDI Reset Support Only, there is no need to 
activate the new level of CDCNET because there is no CDCNET software 
to load. 



The version level of the components of CDCNET are controlled in two 
places: in the INITDCN procedure (stored in file INITDCN on the network 
administration user name) and in the exception list (file ELIST on the 
network administration user name). The exception list maintains the 
default version level for all non-host- connected DIs; INITDCN maintains 
the levels for all other components. 

Format BEGIN,SETVL,DCNPLIB,TOOL = tool, VERSION = ww, ID = id. 

Parameters TOOL 

Name of the component to update. Allowable values are: 
ANACD 
ELIST 
INMD 
MANCC 
NETOU 
NPA 
ALL 

NOTE 

INMD refers to the boot file level INITMDI loads into all host- connected 
DIs, ELIST refers to the exception list, and ALL updates all the tools. 

It is recommended that TOOL = ALL be used for an upgrade or BCU 
installation. Once SETVL has completed, all future load requests for DIs 
and all accesses for ANACD, MANCC, and NPA use ww level software; 
the next initiation of NETOU uses template file TF_id_ww. 
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SETVL (Set Version Level Procedure) (NOS MDI Only) 

VERSION (V) 

Version level of CDCNET you wish to activate. 

ID 

The 1-character identifier for the CHA1 template file. The id character for 
the release template is A. This parameter is required for TOOL=NETOU 
and TOOL = ALL. 

NOTE 



For this procedure to properly process the exception list, the permanent file 
name must be ELIST, and the DEFBD (DEFINE _BOOT_DEFAULTS) 
command must specify the software version level with the text DV = 
ww(16). DV=ww(16) must be on one line. SETVL does not set the boot 
default for specific DIs that are handled in the exception list. 

Examples BEGIN, SETVL, DCNPLIB, TOOL =a1 1 ,VERSION=7305,ID=a. 
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Network Performance Analyzer (NPA) 
Commands 18 

This chapter describes the commands and parameters used by NPA. NPA uses two 
major software components and four minor software components. The commands 
associated with the two major components are: 

Data Reformatting Command REFORMAT.CDCNET_LOG.FILE (REFCLP) 

Report Generator Command CREATE _CDCNET_ANALYSIS_REPORT 

(CRECAR) 

NPA provides you with four other components that allow you to maintain your 
database files, obtain helpful information regarding processing, change expected 
operating limits, and automatically execute procedures periodically. The commands 
associated with these four components are: 

File Maintenance Utilities ARCHIVE _NPA_DATA_BASE (ARCNDB) 

Commands RELOAD _NPA_DATA_BASE (RELNDB) 

Help File Utilities EXPLAIN _CDCNET_LOG .MESSAGE (EXPCLM) 

Commands EDIT_CDCNET_LOG .MESSAGE (EDICLM) 

Change Expected Operating CHANGE .EXPECTED .OPERATING .LIMIT 
Limits Utility Command (CHAEOL) 

Periodic Utility Command SUBMIT BATCH JOB PERIODICALLY (SUBBJP) 

(NOS only) 

NOTE 

The command syntax descriptions used in this chapter are oriented toward the 
interactive user. Batch users on NOS must add the appropriate command statement 
terminators. 
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Accessing NPA 

Accessing NPA 

Access to NPA on NOS is accomplished by entering: 
NPA 

This command does all of the setup necessary to run NPA. The default attribute file 
NPAATTR is made local with this command along with the necessary library files 
needed for NPA command execution. 

On NOS/VE only, you must make NPA available to your job with the following 
command: 

CREATE_COMMAND_LIST_ENTRY $SYSTEM.CDCNET.VERSION_INDEPENDENT.COMMAND_LIBRARY 
You then enter NPA and the following prompt appears: 
np/ 

You may now enter NPA commands as well as system commands. To exit the utility 
(this disables NPA commands, and the np/ prompt no longer appears), enter: 

quit 
NOTE 



If you are using NOS/VE, you can use the Concurrent Maintenance Library for the 
Virtual Environment (CML/VE) to interactively generate some of the NPA reports. See 
the CML/VE Reference manual or the CDCNET Hardware Installation and 
Troubleshooting manual for information on CML/VE usage. 

If you are using NOS, you can use the Common Maintenance Software Interface (CMSI) 
to interactively generate some of the NPA reports. See the CML Reference manual or 
the CDCNET Hardware Installation and Troubleshooting manual for information on 
CMSI usage. 
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ARCHIVE_NPA_DATAJBASE (ARCNDB) 



ARCHIVE _NPAJDATAJBASE (ARCNDB) 

Purpose You use the ARCNDB procedure to remove records from the NPA 
databases and archive this information into an archive file. 

Format ARCHIVE _NPA _DATA _BASE 

ARCHIVE _FILE = filename/reference 

ARCHIVE _FILE JJSER JfAME=username (NOS only) 

DATA _BASE= keyword (or list of keywords [NOS/VE only]) 

DATA J3ASE _FILE JJSER _NAME=username 

BEGIN JDATE =yymmdd 

BEGIN _TIME=hhmms8 

END J) ATE =yymmdd 

END _TIME = hhmmss 

OUTPUT = filename/reference 

BEGIN JDATE JJFFSET=days 

END _DATE _OFFSET=days 

STATUS = status variable (NOS/VE only) 

Parameters ARCHIVE _FILE (AF) 

Specifies the name of the file name (seven- character file for NOS or a 
standard file reference on NOS/VE) that receives the archived data. 

NOTE 

On NOS, this file must be a mass storage file. ARCNDB cannot archive 
directly to magnetic tape files. 

ARCHIVE JFILE JUSER JfAME (AFUN) (NOS only) 

Specifies the user name (catalog) from which the archive file is to be 
acquired if the file is not already local to the current job. If the archive 
file is not found in the specified user catalog, a local file with the same 
name is created to hold the archived data. Default is the current user. 

DATA_BASE (DB) 

Specifies the NPA database you want to archive. Any one (or list for 
NOS/VE only) of the following keywords can be entered as a valid 
database value: 

Keyword Description 

CONF Configuration statistics database. 

CONN Connection statistics database. 

DIOS Device operating statistics database. 

ETHR Ethernet statistics database. 

EVNT Event log database. 

HDLC HDLC statistics database. 

HERR Hardware message database. 



60000414 C 



Network Performance Analyzer (NPA) Commands 18-3 



ARCHIVE_fTPA _DATA._BASE (ARCNDB) 



Keyword Description 



LOAD Loader statistics database. 

MCIS Mainframe channel statistics database. 

SERR Software message database. 

SESS Session statistics database. 

SUMM Summary accounting statistics. 

TELN TELNET connection statistics database. 

TERM Terminal statistics database. 

USER User database. 

X25C X.25 connection statistics database. 

ALL All of the databases in this list. 

Default value is ALL. 

DATA _PASE JFILE _USER _NAME (DBFUN) 

On NOS, this parameter specifies the user name from which the NPA 
databases are acquired. NPA databases must be permanent files to be 
archived. Local files of the same name as the databases are returned. 
Default is the current user name. 

On NOS/VE, this parameter specifies the catalog from which the NPA 
databases are acquired. Databases must be permanent files to be archived. 
This file cannot be $LOCAL. Files of the same name as the databases in 
$LOCAL are detached. Default is the current working catalog, if 
permanent; otherwise $USER. 

BEGIN _DATE (BD) 

Specifies the earliest date from which records are to be archived (yy=year, 
mm = month, dd=day). Only those records recorded during or after the 
begin date are archived. Default is 000101. 

BEGIN JTIME (BT) 

Specifies the earliest time of day on the begin date from which the records 
are to be archived (hh=hour, mm = minute, ss= second). Only records 
recorded after the begin time on the begin date are archived. Default is 
000000. 

END _D ATE (ED) 

Specifies the last date from which records are to be archived (yy=year, 
mm=month, dd=day). Only records recorded on or before the end date are 
archived. Default is 991231. 

END JTIME (ET) 

Specifies the latest time of day on the end date that records are to be 
archived (hh=hour, mm=minute, ss=second). Only records recorded on or 
before the end time on the end date are archived. Default is 240000. 
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ARCHIVE_NPAJDAIA_ i BASE (ARCNDB) 



OUTPUT (0) 

Specifies the output file (seven-character file name for NOS or standard 
file reference for NOS/VE) to receive diagnostic messages and processing 
statistics from the archive process. Default is ARCOUT for NOS and 
$LOCAL.ARCOUT for NOS/VE. 

BEGIN J)ATE jOFFSET (BDO) 

Specifies the offset backwards in days (range of through 365) from the 
current date. For example, a value of 1 indicates that the current day 
minus one, or yesterday, is the first day to begin archiving records. This 
parameter cannot be specified with the BEGIN _DATE parameter. Default 
is the BEGIN _DATE value. 

END JDATE JOFFSET (EDO) 

Specifies the offset backwards in days (range of through 365) from the 
current date. For example, a value of 1 indicates that the current day 
minus one, or yesterday, is the last day that records are archived. This 
parameter cannot be specified with the END_DATE parameter. Default is 
the END_DATE value. 

STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 

Examples In this example, all data in the databases collected before 24:00 hours on 
February 8, 1985, are archived into the archive file, NPAARC. 

ARCNDB , DB=ALL , AF=NPAARC , ED-850208 

Aborts and Error Recovery 

The Archive program takes the following action indicated for the condition specified: 

1. Incorrect command syntax or values. 

• Issue appropriate error message to output file and dayfile. 

• Abort program. 

2. Corrupt database file (NOS/VE only). 

• Write the diagnostic "xxxx DATA BASE FILE FOUND CORRUPTED" to the 
ARCNDB output file. 

• Recover all data up to the point of corruption either to the ARCHIVE _FILE or 
to the data retained in the database. 

• Write the diagnostic "xxxx RETAINED RECORDS RECOVERED TO NEW DATA 
BASE" to the ARCNDB output file. The resultant database file is not corrupt. 
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CHANGE .EXPECTED .OPERATING .LIMIT (CHAEOL) 



Purpose 



Format 



Parameters 



Examples 



You use the CHAEOL command to change existing expected operating 
limits. On NOS, you must execute CHAEOL in full screen mode. The 
establishment of expected operations limits enables you to use NPA reports 
to detect unsatisfactory performance conditions in your network. Specific 
limits are defined for applicable reports. These limits are expressed as two 
numbers; an upper limit and a lower limit, both of which appear in the 
column heading portion of your report. Any reported values that do not fall 
within the specified limit range are called to your attention through the 
use of special symbols « and >). If no data is available for a given time 
period, the character string "****•' replaces the ending time field for that 
period. 

CHAEOL initially displays the current limits for the report you specify. 
You may then change any or all of the limits for the report. 

NOTE 



On NOS, the CHAEOL command is only applicable in full screen mode. 



CHANGE .EXPECTED .OPERATING LIMIT 
REPORT_NAME = name 

STATUS =status variable (NOS/VE only) 

REPORT_NAME (RN) 

Specifies the name of the report for which you are changing expected 
operating limits. If there are no expected operating limits for the selected 
report, an error message is issued. 

One of the following names must be entered as valid report name: 
Name Description 



ETHRRP2 Ethernet report on frames and error statistics. Limits are 
expressed as numbers of instances. 

MCISRP3 Mainframe channel report on bad/good block input/output 
statistics. Limits are expressed as percents. 

TERMRP1 Terminal report on good/bad block input/output statistics. 
Limits are expressed as percents. 

STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 

In this example, the current NPA expected operating limits for report 
ETHRRP2 are displayed on your terminal screen. You change the current 
limits by entering new limits in their place. 

CHAEOL, ETHRRP2 
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Aborts and Error Recovery 

For NOS, the CCL interface responses to incorrect values are utilized for checking 
input parameters. The CCL procedure takes an abort exit if the application fails. This 
exit indicates that the application has failed. Responses from normal system job 
commands indicate the reason the job failed. 

For NOS/VE, SCL sets the STATUS parameter to an abnormal condition. 
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CREATE _CDCNET_ANALYSIS _REPORT (CRECAR) 

Purpose CRECAR is used to generate NPA reports. The parameters you use identify 
the reports you want to generate, the time interval that your reports cover, 
the identity of the system (DI) to which the reports apply, the output file 
name, whether the output file is added to or rewound, and the name of the 
catalog from which the database files are to be acquired. 

Format CREATE _CDCNET_ANALYSIS ..REPORT 

REPORT_NAME = report name (or list of report names [NOS/VE 

only]) 

DATA _BASE _FILE JUSER _NAME = username 

BEGIN _DATE =yymmdd 

BEGIN JTIME = hhmm 

END _DATE =yymmdd 

END JTIME =hhmm 

BEGIN J)ATE_OFFSET= days 

END JJATE _OFFSET=days 

SYSTEM _JD= hexadecimal number (or list of hexadecimal numbers 

[NOS/VE only]) 

OUTPUT = filename/reference 

APPEND = yes or no (NOS only) 

LOG _2Z>= decimal number or list of decimal numbers [NOS/VE only]) 

EXCLUDE _JLOG _JD= decimal number or list of decimal numbers 

[NOS/VE only]) 

SEVERITY=i, w, e, f, or c 

COMPRESS =yes or no 

STATUS = status variable (NOS/VE only) 

Parameters REPORT _NAME (RN) 

On NOS, this parameter specifies the report name you want to generate. 
On NOS/VE, this parameter specifies a list of report names you want to 
generate. On both NOS and NOS/VE, the output is written to the file 
specified by the OUTPUT parameter. 

One or more of the following keywords can be entered as valid report 
name values: 

Keyword Description 

ALL All reports are created except USERRP1. 

DAILY All daily reports are created. These include C0NNRP2, 

DI0SRP2, DI0SRP4, HDLCRP2, MCISRP2, TELNRP2, and 
X25CRP2. 

HOURLY All hourly reports are created. These include CONNRP1, 
DIOSRP1, DIOSRP3, ETHRRP1, ETHRRP2, HDLCRP1, 
HDLCRP3, LOADRP1, MCISRP1, MCISRP3, SESSRP1, 
TELNRP1, TERMRP1, TERMRP2, and X25CRP1. 



18-8 CDCNET Commands 



60000414 C 



CREATE.CDCNETJUStALYSIS JtEPORT (CRBCAR) 



Keyword Description 



MESSAGS All hardware and software message reports that are sorted 
by date and time are created. These include EVNTRP1, 
HRDWRP1, and SFTWRP1. 

SEVERTY All hardware and software message reports that are sorted 
by severity are created. These include EVNTRP2, 
HRDWRP2, and SFTWRP2. 

STATIST All statistical reports are created. These include CONNRP1, 
CONNRP2, DIOSRP1, DIOSRP2, DIOSRP3, DIOSRP4, 
ETHRRP1, ETHRRP2, HDLCRP1, HDLCRP2, HDLCRP3, 
LOADRP1, MCISRP1, MCISRP2, MCISRP3, SESSRP1, 
TELNRP1, TELNRP2, TERMRP1, TERMRP2, X25CRP1, and 
X25CRP2. 

TERMINL All terminal and connection reports are created. These 

include CONNRP1, CONNRP2, TERMRP1, and TERMRP2. 

CONFRP1 Configuration report on an hourly status of DI hardware and 
software. 

CONNRP1 Hourly connection report on the number of connections 
initiated and terminated. 

CONNRP2 Daily connection report on the number of connections 
initiated and terminated. 

DIOSRP1 Hourly device operating report on central processor unit 

(CPU) and memory utilization statistics. 

DIOSRP2 Daily device operating report on CPU and memory 
utilization statistics. 

DIOSRP3 Hourly device operating report on memory state transitions 

statistics. 

DIOSRP4 Daily device operating report on memory state transitions 
statistics. 

ETHRRP1 Hourly Ethernet report on transmit and collision channel 
statistics. 

ETHRRP2 Hourly Ethernet report on frames and error statistics. 

EVNTRP1 Event log report sorted by date and time. 

EVNTRP2 Event log report sorted by severity. 

EVNTRP3 Event log message frequency and severity summary. 

EVNTRP4 Event log message frequency and severity summary reported 
by DI. 
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Keyword Description 



HDLCRP1 Hourly HDLC report on usage. 

HDLCRP2 Daily HDLC report on usage. 

HDLCRP3 Hourly HDLC report on error statistics. 

HRDWRP1 Hardware message report sorted by date and time. 

HRDWRP2 Hardware message report sorted by severity. 

HRDWRP3 Hardware log message frequency and severity summary. 

HRDWRP4 Hardware log message frequency and severity summary 
reported by a DI. 

LOADRP1 Hourly loader statistics report. 

MCISRP1 Hourly mainframe channel report on input/output block 
statistics. 

MCISRP2 Daily mainframe channel report on input/output block 
statistics. 

MCISRP3 Mainframe channel report on bad/good block input/output 
statistics. 

SESSRP1 Hourly session statistics report on PDUs received and 
transmitted. 

SFTWRP1 Software message report sorted by date and time. 

SFTWRP2 Software message report sorted by severity. 

SFTWRP3 Software log message frequency and severity summary. 

SPTWRP4 Software log message frequency and severity summary 
reported by a DI. 

TELNRP1 Hourly TELNET connection report for number of connections 
initiated, terminated, average connect time, and maximum 
connect time. 

TELNRP2 Daily TELNET connection report for number of connections 
initiated, terminated, average connect time, and maximum 
connect time. 

TERMRP1 Hourly terminal report on good/bad block input/output 
statistics. 

TERMRP2 Hourly terminal statistics report online characters 
input/output. 
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Keyword Description 



USERRP1 Unsorted user message report. 

X25CRP1 X.25 connection statistics report for number of connections 
initiated and terminated, average connect time, and 
maximum connect time. 

X25CRP2 Daily X.25 connection statistics report for number of 

connections initiated, terminated, average connect time, and 
maximum connect time. 

NOTE 

No CRECAR report exists which draw upon data stored in the NPBSUMM 
database. See How to Create Customized NPA Reports Using IPF2 
Database Files in the CDCNET Network Operations and Analysis manual 
for an example report derived from this database. 

DATA_flASE_FILE_USER_NAME (DBFUN) 

Specifies the user name (catalog) from which the database(s) are to be 
acquired. The databases must be permanent files (direct access file on 
NOS). If a local file exists with the same name as the database file you 
want, it is returned and then reattached. Default is the current user for 
NOS. For NOS/VE, default is the current working catalog if permanent; 
otherwise, $USER. 

BEGIN JD ATE (BD) 

Specifies the date that begins your selected reporting period (yy=year, 
mm = month, dd=day). Default is 000101. 

BEGIN JTIME (BT) 

Specifies the time that report generation is to begin (hh=hour, 

mm = minute). This time applies only to records with the same date as the 

BEGIN _DATE parameter. Default is 0000. 

END _D ATE (ED) 

Specifies the final date of the report period (yy=year, mm = month, 
dd=day). Default is 991231. 
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ENDJTIME (ET) 

Specifies the time that report generation is to end (hh=hour, 

mm = minute). This applies only to records with the same date as the 

END_DATE parameter. Default is 2400. 

BEGIN JDATE JOFFSET (BDO) 

Specifies the offset backwards in days (range of through 365) from the 
current date. For example, a value of 1 indicates that the current day 
minus one, or yesterday, is the first day to begin generating reports. This 
parameter cannot be specified with the BEGIN _DATE parameter. Default 
is the BEGIN JDATE value. 

END JDATE JOFFSET (EDO) 

Specifies the offset backwards in days (range of through 365) from the 
current date. For example, a value of 1 indicates that the current day 
minus one, or yesterday, is the last day that reports are generated. This 
parameter cannot be specified with the END_DATE parameter. Default is 
the END_DATE value. 

SYSTEM JD (SID) 

For NOS, this parameter specifies the last six hexadecimal digits of the 
system identification address of the DI for which the reports are being 
selected. The first six hexadecimal digits are always 080025. If the selected 
SID equals 000000, all SIDs are selected. 

For NOS/VE, this parameter specifies a list of the last six hexadecimal 
digits of one to ten SIDs to include in the report. If one of the list of SIDs 
equals 000000, all SIDs are selected. 

On both NOS and NOS/VE, if the parameter is selected, only log messages 
with SIDs matching the designated SIDs are used in creating reports. 
Default is all SIDs selected for inclusion in reports. 
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OUTPUT (0) 

Specifies the file name (seven- character file name on NOS or standard file 
reference on NOS/VE) that is to contain the report. For NOS, the default 
value is CREOUT. For NOS/VE, the default value is $LOCAL.CREOUT. 

NOTE 

On NOS, this file is a Control Data display code file. It must be viewed 
interactively in normal mode or appropriately printed; otherwise, some data 
may appear garbled. 

APPEND (NOS only) 

YES specifies that the report created is to be directly written to the end of 
the output file. NO specifies that the output file is rewound before the 
created report is added. If the file is OUTPUT, reports are always 
appended. If not specified, the output file position remains as is. 

LOGJD (U) 

On NOS, this parameter specifies a single one- to five- digit log ID to 
select for report generation. 

On NOS/VE, this parameter specifies a list of one to ten log IDs of one to 
five digits to select for report generation. 

On both NOS and NOS/VE, this parameter is processed by the CONF, 
EVNT, HRDW, SFTW, and USER type reports only. When specified, only 
log messages with log IDs matching the designated log ID(s) are used in 
creating reports. When omitted, the selection of log IDs is determined by 
the presence or absence of the EXCLUDE _LOG_ID parameter. If both the 
LI and ELI parameters are omitted, all log IDs are selected for inclusion 
in the reports. 

The LI and ELI may not be specified together. 
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EXCLUDE JsOGJD (ELI) 

On NOS, this parameter specifies a single one- to five- digit log ID to 
exclude from the reports. 

On NOS/VE, this parameter specifies a list of one to ten log IDs of one to 
five digits to exclude from the reports. 

On both NOS and NOS/VE, this parameter is processed by the CONF, 
EVNT, HRDW, SFTW, and USER type reports only. When specified, only 
log messages with log IDs matching the designated log ID(s) are excluded 
from the reports. When omitted, the selection of log IDs is determined by 
the presence or absence of the LOG_ID parameter. If both the LI and ELI 
parameters are omitted, all log IDs are selected for inclusion in the 
reports. 

The LI and ELI may not be specified together. 

SEVERITY (S) 

Specifies the starting severity level to include in the reports. All log 
messages with this severity level or higher are reported. The highest level 
of severity is C (Catastrophic). 

This parameter is processed by the EVNT, HRDW, and SFTW reports only. 
The default value is I (Informative). All severity levels are then included. 
Any of the following characters can be entered as a valid severity level: 

Character Severity 



I 


Informative 


w 


Warning 


E 


Error 


F 


Fatal 


C 


Catastrophic 



COMPRESS (C) 

YES specifies that reports are compressed. Default is NO, which specifies 
that no reports are compressed. 

A compressed report does not contain a report heading page, data page 
headers, column headers or embedded page eject characters. It consists of 
an initial page eject followed by log message text (event type reports) or 
data (statistics reports). 

This parameter increases report generation time. 

STATUS (NOS/VE only) 

This is the standard NOS/VE System Command Language (SCL) status 
variable. There is no default value. 
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Examples In this NOS example, report ETHRRP2 is created to report statistics 

generated from the DI with the system ID of 123456 between 00:00 hour 
on January 1, 1985, and 24:00 January 2, 1985. ETHRRP2 is added to the 
end of the default output file CREOUT. The database file user name is the 
current user. 

CRECAR , RN=ETHRRP2 , BD=850 101, E0=850 1 02 , SID= 1 23456 , APPEND=yes 

Aborts and Error Recovery 

For NOS, the CYBER Control Language (CCL) interface responses to incorrect values 
are utilized for checking input parameters. The CCL procedure takes an abort exit if 
the application fails. This exit indicates that the application has failed. Responses from 
normal system job commands indicate the reason the job failed. 

For NOS/VE, the SCL sets the STATUS parameter to an abnormal condition. 
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EDIT_CDCNET_LOG .MESSAGE (EDICLM) 

Purpose You use EDICLM to create, add to, or change the site information section 
of a CDCNET log message. 

Format EDIT _CDCNET_.LOG_.MESS AGE 

MESSAGE _NUMBER = log id number 

EDITOR = type (NOS only) 

STATUS = status variable (NOS/VE only) 

Parameters MESSAGE .NUMBER (MN) 

Specifies the log identifier number of the log message to be edited. On 
NOS, this parameter must consist of five digits and must be zero-filled on 
the left (a log message number of 984 is represented as 00984.) 

EDITOR (E) (NOS only) 

Specifies the type of editor to be used during your edit. Valid types are 
FSE, EDIT, or XEDIT. Default is FSE. 

STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 

Examples In this NOS example, log message number 00001 appears on your terminal 
screen, and you may edit the site information portion of the message using 
FSE. 

EDICLM. MN=00001, FSE 
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EXPLAIN _CDCNET_LOG .MESSAGE (EXPCLM) 

Purpose You use EXPCLM to receive the following information on CDCNET log 
messages: 

• The purpose of the message 

• Actions required, if any 

• Site information concerning the log message 

The message purpose section is an expanded explanation of your CDCNET 
log message. The actions required section tells you the action to be taken 
for the log message. The site information is provided by your site and 
contains any information you consider relevant to the log message. 

Format EXPLAIN _CDCNET_LOG .MESSAGE 

MESSAGE .NUMBER =Tog id number or LIST 

STATUS = status variable (NOS/VE only) 

Parameters MESSAGE .NUMBER (MN) 

Specifies the log message number of the log message for which you want 
information. For NOS, this parameter must consist of five digits and must 
be zero-filled on the left. (A log message number of 984 is represented as 
00984.) If LIST is selected, it specifies that all the log message numbers 
with their associated names are listed. 

STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 

Examples In this example, log message number 00001 appears on your terminal 
screen. 

EXPCLM, MN-00001 

Aborts and Error Recovery 

For NOS, the CCL interface responses to incorrect values are utilized for checking 
input parameters. The CCL procedure takes an abort exit if the application fails. This 
exit indicates that the application has failed. Responses from normal system job 
commands indicate the reason the job failed. 

For NOS/VE, the SCL sets the STATUS parameter to an abnormal condition. 
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REFORMAT_CDCNETJLOG_FILE (REFCLF) 

Purpose REFCLF is used to execute the reformatting process. REFCLF performs the 
following: 

• Converts network log file records into database records 

• Transfers the converted records into appropriate data files 
REFCLF generates the following databases: 
NPA Database Definition Type of Database 



NPBACNT 


Accounting information 


Account 


NPBCONF 


Configuration messages 


Event 


NPBCONN 


Connection statistics 


Event 


NPBDIOS 


Device operating statistics 


Statistic 


NPBETHR 


Ethernet statistics 


Statistic 


NPBEVNT 


Event log messages 


Event 


NPBHDLC 


High-Level Data Link Channel 
(HDLC) statistics 


Statistic 


NPBHERR 


Hardware messages 


Event 


NPBLOAD 


Loader statistics 


Event 


NPBMCIS 


Mainframe channel statistics 


Statistic 


NPBSERR 


Software messages 


Event 


NPBSESS 


Session statistics 


Statistic 


NPBSUMM 


Summary statistics 


Statistic 


NPBTELN 


TELNET connection statistics 


Statistic 


NPBTERM 


Terminal statistics 


Statistic 


NPBUSER 


User messages 


Event 


NPBX25C 


X.25 connection statistics 


Event 


NOTE 






REFCLF does not support full screen execution. 
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Format REFORMAT_CDCNET_LOG_FILE (A period must follow the command 

for NOS. A comma or blank must follow the command for NOS/VE.) 
LOG JFILE = filename/reference or list of filename/reference 
LOG JFILE _USER_NAME= name (NOS only) 
ATTRIB UTE _FILE = filename/reference 
ATTRIBUTE JFILE JJSER JSfAME=name (NOS only) 
DATA_BASE=value or list of value 
DATA _BASE JFILE _USER J*AME=name 
USER = attributes) or ALL 
BEGIN _DATE =yymmdd 
BEGIN JTIME = hhmmss 
END J) ATE =yymmdd 
END JTIME = hhmmss 
STATISTICS _INTERVAL=value 
OUTPUT = filename/reference 
LOG JFILE _LIST= filename/reference 
STATUS =status variable (NOS/VE only) 

Parameters LOG JFILE (LF) 

Specifies a filename (seven-character file name on NOS or standard file 
reference on NOS/VE) or list of CDCNET log files (filenames) that 
REFCLF processes. A maximum of 10 log files can be specified. On NOS, 
if no log file is specified, the reformatter finds up to 30 files beginning 
with NL or NETLFmid and uses them. On NOS/VE, if no log file is 
specified, the reformatter accesses and processes up to 30 cycles of the 
$SYSTEM.CDCNET.LOG file. 

LOG JFILE JUSER _NAME (LFUN) (NOS only) 

Specifies the user name (catalog) from which the log files are to be 
acquired. If the file is already local to the job, no acquire is performed. 
Default is SYSTEMX. 

ATTRIBUTE _FILE (AF) 

Specifies the attribute file (seven- character file name on NOS or standard 
file reference on NOS/VE) that contains attribute information for the log 
messages. The attribute information tells REFCLF where to collect specific 
log entries. If no attribute file is specified, the standard NPAATTR file is 
used. The access command NPA makes the standard NPAATTR file local to 
the job. 

The attribute file is a text file of log message identifier (ID) numbers and 
associated attributes in the following format: 

nnn aa aa ... 

nnn is the log message ID number in decimal format, and aa is a one- to 
four- character attribute code associated with the log message (blanks are 
used as separators between fields). A log message can have one or more 
associated attributes. The following are valid attributes: 
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Attribute 


Description 


A 


Accounting 


HE 


Hardware messages 


SE 


Software messages 


S 


Statistics 


EL 


Events log 



X..XXXX 



NOTE 



User- defined one to four alphanumeric characters 
(cannot be ALL) 



REFCLF accepts both sorted and unsorted attribute files. However, 
REFCLF processing time increases if the file is unsorted. Therefore, 
presenting REFCLF with a sorted file is recommended. 



The attributes provide the association between a log message and an NPA 
database. A log message is reformatted to a particular database or 
databases, depending on its attributes, as follows: 



Attribute 


Database 


A 


NPBACNT 


HE 


NPBHERR 


SE 


NPBSERR 


S 


(See note) 


EL 


NPBEVNT 


X..XXXX 


NPBUSER 



NOTE 



The S (statistics) attribute is valid only for specific predefined log 
messages. These messages are predefined to NPA and targeted to certain 
related databases. For example, log message 166 is a terminal statistics 
message that, with an attribute of S, is directed to NPBTERM. An S 
attribute for log messages other than those that are predefined has no 
effect. The log message is discarded if no other attribute is specified. 

Log messages with user-defined attributes (X..XXXX) may only be selected 
by use of the REFCLF USER (U) parameter. If a log message has an 
identifier which is not in the attribute file, the message is discarded unless 
the USER (U) parameter is set to ALL. Setting USER to ALL directs all 
log messages to the NPBUSER database. 
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ATTRIBUTE JFILE _USER JJAME (AFUN) (NOS only) 

Specifies the user name (catalog) from which the directive file is acquired. 
If this file is already local to the job, no acquire is performed. The access 
command NPA makes the standard NPAATTR file local to the job. Default 
is current user. 

DATABASE (DB) 

Enter one or more values from the following value list. Either the DB 
parameter or the USER parameter must be specified. If only the USER 
parameter is specified, the default is none. 

Value Description 

ALL All of the messages and statistics in this list except ACNT are 
written to their respective files. 

ACNT Accounting log messages are written to the NPBACNT file. If 
this option is not specified, the accounting file is not written. 

CONF Device interface (DI) configuration log messages are written to 
the NPBCONF file. If this option is not specified, the DI 
configuration file is not written. 

CONN DI connection log messages are written to the NPBCONN file. If 
this option is not specified, the DI connection file is not written. 

DIOS DI operating statistics log messages are written to NPBDIOS file. 
If this option is not specified, the DI operating statistics file is 
not written. 

ETHR Ethernet statistics information is written to the NPBETHR file. 
If this option is not specified, the Ethernet statistics are not 
written. 

EVNT DI event log messages are written to the NPBEVNT file. If this 
option is not specified, the DI event log messages are not 
written. 

HDLC HDLC statistic log messages are written to the NPBHDLC file. If 
this option is not specified, the HDLC statistics file is not 
written. 

HERR DI hardware errors are written to the NPBHERR file. If HERR 
is not specified, the DI hardware errors are not written. 

LOAD System loader statistics information is written to the NPBLOAD 
file. If this option is not specified, the system loader statistics are 
not written. 

MCIS Mainframe channel statistics are written to the NPBMCIS file. If 
MCIS is not specified, the mainframe channel statistics are not 
written. 

SERR DI software errors are written to the NPBSERR file. If SERR is 
not specified, the DI software errors are not written. 
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Value Description 



SESS The session layer statistic log message is written to the 

NPBSESS file. If this option is not specified, the session layer 
statistics file is not written. 

SUMM Connection statistics for Terminal Support, X.25 AsyncTip, Server 
TELNET TIP, X.25 Terminal Gateway, X.25 Gateway, 
Passthrough, and Device Outcall are written to the file 
NPBSUMM. If SUMM is not specified, the NPBSUMM file is not 
written. 

TELN TELNET connection log messages are written to the NPBTELN 
file. If TELN is not specified, the TELNET connection file is not 
written. 

TERM Terminal statistics are written to the NPBTERM file. If not 
specified, the terminal statistics are not written. 

X25C X.25 connections are written to the NPBX25C file. If X25C is not 
specified, the NPBX25C file is not written. 

ALL All of the messages and statistics in this list except ACNT are 

written to their respective files. 

DATA_BASE_FILE_USER_NAME (DBFUN) 

On NOS, this parameter specifies the user name from which the NPA 
database files are to be acquired. If a database file is already local to the 
job, then no acquire is performed. If a database file is not found, it is 
created as a local file. Default is the current user name. 

On NOS/VE, this parameter specifies the catalog from which the NPA 
database files are to be acquired. If a database file is not found, it is 
created in the specified (or default) catalog. Default is the current working 
catalog, if permanent; otherwise, $USER. 

USER (U) 

Specifies that the NPBUSER database is to be written. The purpose of this 
parameter is for diagnosis of log file contents. The attribute, or attributes, 
specified determine which log messages are to be selected. Values consist 
of one or more attributes listed in the attribute file or ALL. If the value 
ALL is specified, all log messages are written to the USER database. 
Either the USER or DB parameter must be specified. If only the DB 
parameter is specified, the USER database is not written. 

BEGIN JOATE (BD) 

Specifies the beginning date of the log messages to be reformatted 
(yy=year, mm = month, dd=day). Only messages with a date that is equal 
to or greater than this parameter are reformatted. Default is 000101. 

BEGIN JTIME (BT) 

Specifies the beginning time of the log messages to be reformatted 
(hh=hours, mm=minutes, ss=seconds). Only messages with a time equal 
to or greater than begin date are reformatted. Default is 000000. 
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END J) ATE (ED) 

Specifies the end date of the log messages to be reformatted (yy=year, 
mm = month, dd=day). Only messages with a date equal to or less than 
this parameter are reformatted. Default is 991231. 

ENDJTIME (ET) 

Specifies the ending time of the log messages to be reformatted (hh=hour, 
mm = minutes, ss= seconds). For log messages with a date equal to the 
ending date, only messages with a lime less than or equal to this value 
are reformatted. Default is 240000. 

STATISTICS .INTERVAL (SI) 

For this release and future releases, this parameter is ignored. 

OUTPUT (O) 

Specifies the output file (seven- character file name on NOS or standard file 
reference on NOS/VE) to which REFCLF writes diagnostic and processing 
statistics. Default is REFOUT for NOS. Default is $LOCAL.REFOUT for 

NOS/VE. 

LOG _JILE _LIST (LFL) 

Specifies a file name (seven- character file name on NOS or standard file 
reference on NOS/VE) to which a list of completely processed log file 
filenames is written. The same log file list plus an informative message 
are also written to the REFCLF Output (O) file. The LOG_FILE_LIST file 
is in a format suitable for site-written procedures to know the log files 
successfully processed by REFCLF. Site procedures can use this information 
to dump and purge the successfully processed log files. Default is no file 
written. The LFL file format is as follows: 

file name/reference, 
file name/reference 

STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 
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Examples 1. This NOS example shows reformatting of all log files (up to 30) in the 
SYSTEMX user catalog. This includes the CDCNET NETLFmid log file 
and all log files with names beginning with NL. All log messages with 
attributes matching those defined in the NPAATTR default attribute file 
are reformatted. All databases in the user catalog, except NPBACNT 
and NPBUSER, are updated if corresponding log messages are 
encountered. Information pertaining to this REFCLF run is written to 
the REFOUT default file. 

REFCLF. DB=ALL 

2. In this NOS example, REFCLF is used to reformat log messages in the 
three log files NL09AA, NL09BB, and NL09CC in the SYSTEMX user 
catalog. Only log messages with attributes matching those in the 
NPAATTR default attribute file and log messages falling in the interval 
from noon September 3, 1985, until midnight September 7, 1985, are 
processed. Only databases NPBACNT, NPBCONN, NPBETHR, and 
NPBSERR in the user catalog are updated. The results of the REFCLF 
run are written to the REFREP file, and a list of completely processed 
log files (if any) are written to the PURGLST file. 

RE FCLF . LF= ( NL09AA , NL09BB , NL09CC) , BD-850903 , BT= 1 20000 , ED= 
850907 , DB=( ACNT , CONN . ETHR ,SERR) , 0=REFREP , LFL=PURGLST 

3. This NOS example shows REFCLF being used to extract four log 
messages from the file NLB0910 in catalog LOGCAT and write them to 
the NPBACNT database in catalog DBCAT. Local file ACNTATR is a 
copy of the NPAATTR default attribute file, which has been edited to 
only contain entries for the four log messages. The A accounting 
attribute has been added to each one in the ACNTATR file, as shown 
in the following list: 

00010 A HE EL 

00017 A EL 

00424 A S 

00427 A SE EL 

NOTE 



Only the NPBACNT database is updated or created when this example 
is executed. 



REFCLF . LF=NLB091 , LFUN=LOGCAT , DB=ACNT , DBFUN=DBCAT , AF=ACNTATR 
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This example (figure 18-1) illustrates the command parameters that 
appear in the output file from a REFCLF data reformat run on NOS. 



Network Performance Analyzer Version xxxx 1989/11/11 1:57 PM Page 

** Network Performance Analyzer — Reformat Command Parameters ** 

Attribute file — > npaattr 

Attribute file user name --> NETADMN 

Log file 11st --> FILELST 

Output file — > REFOUT 

Begin Date — > 000101 
Begin Time — > 000000 
End Date --> 991231 
End Time --> 240000 

Log file ( 1 ) --> L0G1R11 
Log file ( 2 ) — > NLA0129 

Log file(s) user name — > SYSTEMX 

Data base file(s) user name — > NETADMN 

Data Base file — > acnt 
Data Base file — > conf 
Data Base file — > conn 
Data Base file — > dios 
Data Base file— -> ethr 
Data Base file — > evnt 
Data Base file — > exts 
Data Base file — > hdlc 
Data Base file — > herr 
Data Base file — > load 
Data Base file — > mcls 
Data Base file — > queu 
Data Base file — > serr 
Data Base file — > sess 
Data Base file — > summ 
Data Base file — > teln 
Data Base file — > term 
Data Base file --> user 
Data Base file — > x25c 



Figure 18-1. Output File Command Parameters 
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This example (figure 18-2) illustrates the attribute file that appears in 
the output file after a REPCLF run. 



Network Performance Analyzer Version xxxx 1989/11/11 1:57 PM Page - 


•« Network Performance Analyzer — Attribute File ** 


00018 EL 




00019 EL 




00020 EL 




00021 EL 




00022 EL 




00057 EL 




00058 EL 


SE 


00059 EL 


SE 


00060 EL 


SE 


00061 EL 


SE 


00062 EL 


SE 


00063 EL 


SE 


00064 EL 


SE 


00065 EL 


SE 


00066 EL 


SE 


00067 EL 




00068 EL 




00069 EL 


SE 


00070 EL 


SE 


00071 EL 


SE 


00072 EL 


SE 


00073 EL 


SE 


00089 EL 





00090 EL 

00091 SE 

00092 SE 

00093 SE 

00094 S 

00161 SE EL 

00162 SE EL 

00163 SE EL 

00164 EL 

00165 EL 



••End of Attribute File •• 



Figure 18-2. Output File Attribute File 
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6. This example (figure 18-3) illustrates the error messages that may 
appear in the output file after a REFCLF run. 



1. The following messages report difficulties in processing log file protocol 
data units. 

PROBLEM ENCOUNTERED IS: type of problem encountered 

EXPECTING THE FOLLOWING FIELD: field name expected 

CURRENT LOG FILE PDU NUMBER PROCESSING: xxxxxx 

CURRENT LOG ID: xxxx DATE/TIME: yy/mm/dd hh.mm.sssss 

LOG FILE IS: xxxxxxx TOTAL PDU LENGTH: xxxxxx PDU HEADER LENGTH: xxxxxx 

PDU BODY LENGTH: XXXXXX CURRENT BYTE IN PDU BODY: xxxxxx 
RECOVERY ATTEMPTED: type of recovery attempted 

INFORMATIVE MESSAGE: LOG MESSAGE nnnnn REFORMATTING INCOMPLETE. 
MDU PARAMETER STRING > 256 CHARACTERS. 
DATE/TIME: yy/mm/dd hh.mm.sssss 

2. On NOS, the following error messages are written to the output file 1f 
REFCLF encounters errors while attempting to access the database files. 

DATA BASE NOT FOUND OR NO WRITE PERMIT. LOCAL FILE CREATED — > LFN = filename 

DATA BASE ACCESS ERROR, PROCESSING BYPASSED --> LFN = filename 

DATA BASE BUSY, PROCESSING BYPASSED — > PFN = filename, UN = username 

3. The following message occurs when an attempt Is made to process an MDU 
whose integer value Is greater than 48 bits on NOS or 64 bits on NOS/VE. 

INFORMATIVE MESSAGE: LOG MESSAGE XXXX CONTAINS AN MDU WHOSE 
INTEGER REPRESENTATION IS > nn BITS. 
AN INTEGER VALUE OF HAS BEEN WRITTEN 
TO THE DATABASE. 
DATE/TIME: yy/mm/dd hh.mm.sssss 

nn = 48 (NOS) or 64 (NOS/VE) 



Figure 18-3. Output File Error Messages 



(Continued) 
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'Continued) 



». The following error messages are encountered while processing the 
attribute file. 

ERROR - NO ATTRIBUTE FILE FOUND. 

ERROR - ATTRIBUTE FILE IS EMPTY. 

ERROR - THE FOLLOWING ATTRIBUTE FILE LINE HAS A LOG ID OUT OF RANGE 

ERROR - THE FOLLOWING ATTRIBUTE FILE LINES ARE IGNORED 

ERROR - TOO MANY LOG IDS HAVE BEEN DEFINED. CURRENT MAX IS 1228 

ERROR - THE ATTRIBUTE FILE CONTAINS THE FOLLOWING DUPLICATE LOG IDS - 
xxxxx xxxxx . . . 

INFORMATIVE - THE FOLLOWING ATTRIBUTE FILE LINE HAS AN ATTRIBUTE CODE 
WHICH IS GREATER THAN 4 CHARACTERS IN LENGTH. FIRST 4 
CHARACTERS ARE USED. 

INFORMATIVE - THE FOLLOWING ATTRIBUTE FILE LINE HAS A LOG ID WITH NO 
ATTRIBUTES 

** BAD ATTRIBUTE FILE - REFCLF ABORT ** 



Figure 18-3. Output File Error Messages 
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This example (figure 18-4) illustrates the text that appears in the 
REFCLF output file if the LFL parameter is specified. For this 
example, the LFL file (FILELST) contains the following text: 

LOG1R11, 
NLA0129 



Network Performance Analyzer Version 1.10/4103 1989/11/11 1:57 PM Page - xx 

The following log files have been completely processed to the CONF, 
CONN, DIOS, ETHR, EVNT, EXTS, HERR. HDLC. LOAD, MCIS, QUEU, SERR, SESS, 
sum, TELN. TERM, and X25C databases: 

LOG1R11, 
NLA0129 



Figure 18-4. Output File Processed Log Files 
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8. The following two examples (figure 18-5 and 18-6) show the information 
that appears in the output file for statistics pertaining to the REPCLF 
reformatting run. 

Figure 18-5 shows the number of log entries selected for reprocessing to 
each individual database and the number of resultant database records 
written. A single selected log entry may result in multiple database 
records being written to a particular database. A single log entry may 
also be selected for reformatting to multiple databases. For these 
reasons, the number of database records written does not necessarily 
match the number of log entries selected; and the total number of log 
entries selected does not necessarily match the total log entries 
processed for the individual log files. 

Figure 18-6 is a summary, by log file, of the number of log entries 
read, the number of log entries processed, and the number of log 
entries rejected. The time and date of the earliest and latest processed 
log entries on the log file are also listed. The number of log entries 
read represents the total number of log entries on the log file. The 
number of log entries processed represents the total number of log 
entries whose attributes and time/date stamps match the specified 
REFCLF command parameter values (database selected, begin, and end 
time/date) and which have been successfully reformatted and written to 
one or more databases. The number of log entries rejected is 
represented by four totals: ERRORS ENCOUNTERED, NOT IN 
ATTRIBUTE FILE, NOT SELECTED -> DATABASE, and OUTSIDE 
TIME/DATE WINDOW. ERRORS ENCOUNTERED reflects those log 
entries which could not be reformatted due to errors. NOT IN 
ATTRIBUTE FILE reflects those log entries which were not found in 
the attribute file. NOT SELECTED -> DATABASE reflects those 
entries which were not reformatted because they are not targeted to 
databases specified in the REFCLF command. OUTSIDE TIME/DATE 
WINDOW reflects those log entries whose time/date stamps fall outside 
the user specified time/date window. A rejected log entry is included in 
only one of the four totals. 

An additional total may appear if reformatting to the NPBSUMM 
database has been requested and both old (pre L750) and new versions 
of connection statistics log messages 38, 39, 617-620, 1160, 1161, and 
1340-1343 are read from the log file(s). This total represents the 
number of old messages read. The REFCLF NPBSUMM reformatter 
ignores old versions of these log messages because they contain 
incomplete data. 

Performance information follows the log file summaries. CPU time 
used, elapsed time used and log entries read, processed and selected 
and database records written per unit time are listed. Memory 
allocation information is also listed. 
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Network Performance Analyzer Version 1.10/4103 1989/11/11 1:57 PM Page 

** Network Performance Analyzer — Statistics ** 

DATABASE LOG 
DATABASE RECORDS ENTRIES 
NAME WRITTEN SELECTED 



- XXX 



NPBACNT 








NPBCONF 


833 


308 


NPBCONN 


7187 


7187 


NPBDIOS 


721 


721 


NPBETHR 


379 


379 


NPBEVNT 


10605 


10605 


NPBEXTS 








NPBHERR 


58 


58 


NPBHDLC 


68 


68 


NPBLOAD 


107 


107 


NPBMCIS 


320 


320 


NPBQUEU 








NPBSERR 


948 


948 


NPBSESS 


341 


341 


NPBSUMM 


12568 


12568 


NPBTELN 








NPBTERM 


508 


508 


NPBUSER 








NPBX25C 


2962 


2962 



TOTAL 



37605 



37080 



LOG FILE PROCESSING: 



LOG FILE — > LOG1R11 



DATE/TIME OF FIRST PROCESSED 


ENTRY: 86/01/01 


00.02.49049 


DATE/TIME OF LAST PROCESSED 


ENTRY: 86/09/06 


03.20.26026 


LOG ENTRIES READ: 


5723 




LOG ENTRIES PROCESSED: 


5717 




LOG ENTRIES REJECTED: 






ERRORS ENCOUNTERED: 







NOT IN ATTRIBUTE FILE: 


6 




NOT SELECTED -> DATABASE: 







OUTSIDE TIME/DATE WINDOW: 








Figure 18-5. Output File Log Entries 
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Network Performance Analyzer Version 1.10/4103 1989/11/11 1:57 PM Page 
LOG FILE — > NLA0129 

FILE STATUS: FILE FOUND IN SPECIFIED CATALOG. 

DATE/TIME OF FIRST PROCESSED ENTRY: 87/01/28 03.14.50189 

DATE/TIME OF LAST PROCESSED ENTRY: 87/01/29 12.46.53717 

LOG ENTRIES READ: 49055 

LOG ENTRIES PROCESSED: 16301 

LOG ENTRIES REJECTED: 

ERRORS ENCOUNTERED: 

NOT IN ATTRIBUTE FILE: 24 

NOT SELECTED -> DATABASE: 32730 

OUTSIDE TIME/DATE WINDOW: 

TOTALS: LOG ENTRIES READ: 54778 

LOG ENTRIES PROCESSED: 22018 
LOG ENTRIES REJECTED: 32760 

REFCLF CPU PROCESS TIME 

LOG ENTRIES READ PER CPU SECOND 

LOG ENTRIES PROCESSED PER CPU SECOND = 

LOG ENTRIES SELECTED PER CPU SECOND * 

NPA RECORDS WRITTEN PER CPU SECOND 

REFCLF ELAPSED TIME 

LOG ENTRIES READ PER SECOND 

LOG ENTRIES PROCESSED PER SECOND 

LOG ENTRIES SELECTED PER SECOND 

NPA RECORDS WRITTEN PER SECOND 

NUMBER OF PDU PUFFER ALLOCATIONS 

AVERAGE BUFFER SIZE = 4154 

MAXIMUM BUFFER SIZE = 6616 

REFCLF PROCESSING COMPLETE 



XXX 



473.652 CPU SECONDS 
115 ENTRIES/CPU SECOND 
115 ENTRIES/CPU SECOND 
49 ENTRIES/CPU SECOND 
52 ENTRIES/CPU SECOND 
819 ELAPSED SECONDS 
66 ENTRIES/CPU SECOND 
66 ENTRIES/CPU SECOND 
28 ENTRIES/CPU SECOND 
30 ENTRIES/CPU SECOND 
4 



Figure 18-6. Output File Statistics Summary 
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This example (figure 18-7) illustrates the dayfile messages that may 
appear in the output file after a REFCLF run. In general, REFCLF 
actions and error messages are left-justified. REFCLF tasks to be 
completed are indented. The terms ACCOUNTING, STATISTICS, 
EVENT, and USER correspond to the basic NPA record types. 



I. Messages produced as a result of REFCLF command errors: 

ERROR, PARAMETERS DB OR USER MUST BE SPECIFIED 

ERROR, REFCLF MUST BE FOLLOWED BY A PERIOD 

FORMAT ERROR ON COMMAND 

ILLEGAL LOG FILE NAME xxxxxxx 

INCORRECT REFCLF CONTROL CARD 

INVALID DATE: reason 

INVALID TIME: reason 

NO LOG FILES TO PROCESS 

TOO MANY LOG FILES. > nn 

UNKNOWN PARAMETER xxxxxxx 

2. Messages produced during the reformatting process: 

BEGIN REFCLF PROCESSING 

COPY ACCOUNTING LOG MESSAGES 

REFORMAT STATISTICS LOG MESSAGES 

REFORMAT EVENT LOG MESSAGES 

REFORMAT USER LOG MESSAGES 
ERROR - ATTRIBUTE FILE HAS LOG ID OUT OF RANGE 
ERROR - THE ATTRIBUTE FILE CONTAINS DUPLICATE LOG IDS 
ERROR - NO ATTRIBUTE FILE FOUND 
ERROR - ATTRIBUTE FILE EMPTY 
ERROR - TOO MANY LOG IDS HAVE BEEN DEFINED 
INFORMATIVE - ATTRIBUTE FILE HAS LOG ID WITH NO ATTRIBUTES 
INFORMATIVE - ATTRIBUTE FILE HAS CODE > 4 CHARACTERS 
SORTING THE ATTRIBUTE FILE CONTENTS 

DATA BASE ACCESS ERROR, PROCESSING BYPASSED — > LFN = filename 
DATA BASE BUSY, PROCESSING BYPASSED --> PFN = filename, UN = username 
PROCESSING LOG FILE: log file 

LOG FILE READ ERROR-PROCESSING STOPPED: log file 
LOG FILE EMPTY OR NOT FOUND: log file 
LOG FILE READ ERROR-PROCESSING STOPPED 

COMPLETE NPA DATABASE GENERATION 

PREPARE REFCLF STATISTICS 
REFCLF PROCESSING COMPLETE 



Figure 18-7. Dayfile Messages 
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Aborts and Error Recovery 

REFCLF takes the following action for the condition specified: 

1. Incorrect command syntax or parameter values. 

• Issue appropriate error message to output file and dayfile. 

• Abort program. 

2. Parameter specified more than once in REFCLF command. 

• Issue informative message. 

• Use last value specified (NOS only). 

• Give user a choice of values to use (NOS/VE only). 

3. End-of-file is encountered unexpectedly (NOS only). 

• Issue appropriate error message to output file and dayfile. 

• Terminate processing the current log file. Process other log files, if any. 

4. End-of-record is encountered unexpectedly (NOS only). 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

5. Unexpected management data unit (MDU) types (for example, an integer value is 
expected in the log protocol data unit [PDU], but a string value was encountered). 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

6. The log PDU is not in correct format (that is, REFCLF does not recognize a field 
in the log PDU). 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

• Skip record forward is performed on the current log file (NOS only). 

7. The log header is not in correct format (NOS only). 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

• Skip record forward is performed on the current log file. 

8. There is not enough memory to hold a log PDU (NOS only). 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

• Skip record forward is performed on current log file. 
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9. Log PDU contains less than the expected number of MDUs. 

• Issue appropriate error message to output file. 

• The log PDU is ignored. 

10. Attribute file is empty or not found. 

• Issue appropriate informative error message to output file. 

• Abort program. 

11. The log identifier specified in the attribute file is out-of-range, too many log 
identifiers have been specified, or duplicate log identifiers exist. 

• Issue appropriate warning error message to output file. 

• Abort program. 

12. Too many log files. > 10. 

• Issue appropriate warning error message to output file. 

• Abort program. 

NOTE 

Too many log files occurs when more than 10 log files are specified on the 
command; or on NOS, no log file was specified but more than 30 log files were 
found in user name LFUN (SYSTEMX if not specified); or on NOS/VE, no log file 
was specified but more than 30 log file cycles were found for 
$SYSTEM.CDCNET.LOG. 

When this occurs, make separate REFCLF runs specifying 10 or fewer log files. 

13. No log files to process. No log files were specified and REFCLF could not find any 
to process after searching user name LFUN (NOS) or $SYSTEM.CDCNET 
(NOS/VE). 

• Issue appropriate warning error message to output file. 

• Abort program. 
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RELOAD _NPA_D ATA _BASE (RELNDB) 

Purpose You use the RELNDB procedure to reload records from an archive file and 
merge these files into existing NPA databases. 

Format RELOAD JNPA _D ATA _BASE 

ARCHIVE _FILE = filename/reference 

ARCHIVE JFILE_USER_NAME=username (NOS only) 

DATA JBASE= keyword (or list of keywords [NOS/VE only]) 

DATA J3ASE _FILE _USER JSfAME = value 

BEGIN JDATE =yymmdd 

BEGIN _TIME=hhmmss 

END JDATE =yymmdd 

END _TIME=hhmmss 

OUTPUT = filename/reference 

STATUS = status variable (NOS/VE only) 

Parameters ARCHIVE _FILE (AF) 

Specifies the name of the file (seven- character file name for NOS or a 
standard file reference name for NOS/VE) from which the archived data is 
retrieved. 

ARCHIVE _FILE JJSER JSIAME (AFUN) (NOS only) 

Specifies the user name (catalog) from which the archive file is to be 
acquired, if not already local to the job. Default is the current user. 

DATA_BASE (DB) 

Specifies the database (keyword) you want to reload. Any one (or list for 
NOS/VE only) of the following keywords can be entered as a valid 
database value: 

Keyword Description 



CONF Configuration statistics database. 

CONN Connection statistics database. 

DIOS Device operating statistics database. 

ETHR Ethernet statistics database. 

EVNT Event log database. 

HDLC HDLC statistics database. 

HERR Hardware message database. 

LOAD Loader statistics database. 

MCIS Mainframe channel statistics database. 

SERR Software message database. 

SESS Session statistics database identifier. 

SUMM Summary statistics database. 
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Keyword Description 



TELN TELNET connection statistics database. 

TERM Terminal statistics database. 

USER User database. 

X2SC X.25 connection statistics database. 

ALL All of the databases in this list. 

Default is ALL. 

DATAJBASE_FILE_USER_FAME (DBFUN) 

On NOS, this parameter specifies the user name from which the NPA 
databases are acquired. NPA databases must be permanent files to be 
reloaded. Local files of the same name as the databases are returned. 
Default is the current user. 

On NOS/VE, this parameter specifies the catalog from which the NPA 
databases are to be acquired. If a database is not found, it is created in 
the specified (or default) catalog. The NPA databases must be permanent 
files to be reloaded. This parameter cannot be $LOCAL. Files of the same 
name as the database in $LOCAL are detached. Default is $CATALOG if 
permanent; otherwise $USER. 

BEGIN _J)ATE (BD) 

Specifies the earliest date (yy=year, mm = month, dd=day) from which 
records are to be reloaded. Only those records archived during or after the 
begin date are reloaded. Default is 000101. 

BEGIN JTIME (BT) 

Specifies the earliest time of day (hh=hour, mm = minute, ss = second) on 
the begin date from which the records are to be reloaded. Only records 
recorded after the begin time on the begin date are reloaded. If no begin 
time is entered, records recorded after 00:00 hour on the begin date are 
reloaded. 

END J) ATE (ED) 

Specifies the last date (yy=year, mm = month, dd=day) from which records 
are to be reloaded. Only records recorded on or before the end date are 
reloaded. Default is 991231. 

END JTIME (ET) 

Specifies the latest time of day (hh=hour, mm = minute, ss= second) on the 
end date that records are to be reloaded. Only records recorded on or 
before the end time on the end date are reloaded. If no end time is 
entered, records recorded before 24:00 hours on the end date are reloaded. 

OUTPUT (O) 

Specifies the output file (seven- character file name for NOS or a standard 
file reference name for NOS/VE) to receive diagnostic messages and 
processing statistics from the reload process. Default is RELOUT for NOS. 
Default is $LOCAL.RELOUT for NOS/VE. 
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STATUS (NOS/VE only) 

This is the standard NOS/VE SCL status variable. There is no default 
value. 

Examples In this example, all of the database information written to the archive file 
NPAARC between 00:00 hour on January 8, 1985, and 24:00 on February 
8, 1985, is reloaded into the databases. 

RELNDB , DB=ALL , AF=NPAARC , BD-850 108 , ED=850208 

Aborts and Error Recovery 

The Reload program takes the following action indicated for the condition specified: 

1. Incorrect command syntax or values. 

• Issue appropriate error message to output file and dayfile. 

• Abort program. 

2. Corrupt database file (NOS/VE only). 

• Write the diagnostic "xxxx DATA BASE FILE FOUND CORRUPTED" to the 
RELNDB output file. 

• Recover all data up to the point of corruption to the database. 

• Write the diagnostic "NUMBER OF RECORDS RECOVERED- > nnnn" to the 
RELNDB output file. The resultant database file is not corrupt. 
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SUBMIT BATCH JOB PERIODICALLY (SUBBJP) 
NOS MDI Only 

Purpose You execute SUBBJP in batch mode to regulate the periodic execution of 
NPA commands. 

SUBBJP allows you to submit job files to the input queue for processing at 
a periodic rate. The input parameter you specify identifies a batch directive 
file. The batch directive file contains one or more records each of which 
defines: 

• Name of a job file to submit to the input queue 

• User name of the job file to submit to the input queue 

• Start date and time to begin the periodic interval 

• Periodic interval, specified in days, hours, and minutes 

• Last date and time this file was submitted 

SUBBJP determines if a job file is to be submitted, then causes itself to 
roll out until another file is to be submitted. A job file is submitted if the 
difference between the last time it was scheduled and the current time 
exceed the periodic interval specified. The last time is then updated. 

Format SUBBJP 

BDF= filename 

Parameters BDF 

Specifies the name of the batch directive file that contains records defining 
the job file(s) to be submitted periodically and the intervals between job 
submissions. The batch directive file must be indirect access and resident 
in the user's catalog. 

Each batch directive file record consists of eight parameters which must be 
specified on one line and separated by spaces. These parameters and their 
required order are as follows: 
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BDF Record 
Parameters 



Description 



File name 
User name 
Submit date 

Submit time 

Skip day 
Skip time 
Last date run 
Last time run 



Specifies the name of the job file to be submitted. 

Specifies the user name of the job file to be submitted. 

Six digits specifying the year, month, and day to begin 
job file submission. Format: yymmdd. 

Four digits specifying the hour and minute of the 
submit date to begin job file submission. Format: 
hhmm. 

Two digits specifying the number of days to skip. 
Format: dd. 

Four digits specifying the number of hours and minutes 
to skip. Format: hhmm. 

Six digits specifying the year, month, and day on which 
the job file was last submitted. Format: yymmdd. 

Four digits specifying the hour and minute that the job 
file was last submitted. Format: hhmm. 



Examples 1. In this example batch directive file record, file NPAPERD with user 
name NETNPA is to be submitted for execution on a daily basis at 
01:10, beginning on the first of January, 1985. 

NPAPERD NETNPA 850101 0110 01 0000 850101 0110 

2. In this example batch directive file record, file NPAPERD with user 
name NETNPA is to be submitted for execution on a weekly basis, once 
every seven days, beginning at 04:35 on January 1, 1985. 

NPAPERD NETNPA 850101 0435 07 0000 850101 0435 

The following four examples show how to facilitate the generation of the 
necessary files for this procedure: 

1. Batch job directive file (NPABDF). 

NPABT1 NETADMN 850101 0600 01 0000 850101 0600 
NPABT2 NETADMN 850101 0600 07 0005 850101 0600 
NPABT3 NETADMN 850101 0000 00 0100 850101 0000 
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2. Batch job for creating the hourly reports at the end of the day 
(NPABT1). 

NETNPA. 

USER, NETADMN, NETNPA. 

CHARGE,*. 

NPA. 

CRECAR , RN=HOURLY , BDO- 1 , EDO- 1 . 

REWIND,*. 

COPYEI.CREOUT. 

DAYFILE,PL=60. 

ROUTE, OUTPUT, DC=PR. 

EXIT. 

DAYFILE,PL=60. 

ROUTE, OUTPUT, DC=PR. 

3. Batch job for creating daily reports at the end of the week (NPABT2). 

NETNPA. 

USER , NETADMN , NETNPA . 

CHARGE,*. 

NPA. 

CRECAR, RN=DAILY,BD0=7,ED0=1. 

REWIND,*. 

COPYEI.CREOUT. 

DAYFILE.PL-60. 

ROUTE, OUTPUT, DC=PR. 

EXIT. 

DAYFILE,PL=60. 

ROUTE, OUTPUT, DC=PR. 

4. Batch job for causing the reformat process to be run every hour 
(NPABT3). 

NETNPA. 

USER , NETADMN , NETNPA . 

CHARGE,*. 

NPA. 

REFCLF.DB=ALL 

REWIND,*. 

COPYEI.REFOUT. 

DAYFILE.PL-60. 

ROUTE, OUTPUT. DC«PR. 

EXIT. 

DAYFILE,PL«60. 

ROUTE, OUTPUT, DC-PR. 

Aborts and Error Recovery 

The CCL interface responses to incorrect values are utilized for checking input 
parameters. The CCL procedure takes an abort exit if the application fails. This exit 
indicates that the application has failed. Responses from the normal system job 
commands indicate the reason for failure. 
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The DI Dump Analyzer is used to reformat the file produced when a DI system dumps 
its memory on reset. In the default environment, DIs dump their memory whenever 
they are reset, with two exceptions: 1) When the DI is reset manually, with the power 
switch, and 2) When the DI is reset by NETOU's KILL .SYSTEM (KILS) command, 
with the DUMP parameter set to NO. 

The DI Dump Analyzer program runs on the host, where DI dump files are 
maintained. 

If you are using the Dump Analyzer under NOS, you may begin a session at any time 
by using the ANACD command. 

NOTE 

To use the Dump Analyzer under NOS/VE, you must first use the following CREATE _ 
COMMAND _LIST_ENTRY (CRECLE) command: 

CRECLE $SYSTEM . CDCNET . VERSION.INDEPENDENT . COMMAND.LIBRARY 

The CRECLE command makes the Dump Analyzer available to your NOS/VE job. This 
command may be added to your user prolog, so that the DI Dump Analyzer is 
available anytime you log onto the host. Once the Dump Analyzer is available to your 
NOS/VE job, you may begin a Dump Analyzer session with the ANACD command. 



The ANACD command specifies the dump file to be analyzed, the version level of the 
dump, input and output files, and the STATUS parameter (effective only under 
NOS/VE). After you enter the ANACD command on NOS/VE or NOS, the DI Dump 
Analyzer is ready to accept any of the following subcommands: 



DISPLAY_AUTO_DUMP_TABLE 

DISPLAY_BUFFER_CHAIN 

DISPLAY_COMMAND_INFORMATION 

DISPLAY_DATA_QUEUE 

DISPLAY_EXECUTIVE_ERROR_TABLE 

DISPLAY_LINKED_LIST 

DISPLAY_LOG_QUEUES 

DISPLAY_MEMORY_HEADER 

DI SPLAYJWEMOR Y_USERS 

DISPLAY_PROGRAM_VALUE 

DISPLAY_TASK_CONTROL_BLOCK 

HELP 

SELECT_TASK 

VALI DATE_STACK_AREAS 



DISPLAY_BOARD_MAP_TABLE 

DISPLAY.CALLS 

DISPLAY_COMMAND_LIST 

DISPLAY_DI_SYSTEM_STATUS 

DISPLAY_HARDWARE_STATUS 

D I SP L AYJ.I NE_CONTROL_BLOCK 

DISPLAY.MEMORY 

DISPLAY_MEMORY_MAP 

DISPLAY_NETWORK_STATUS 

DISPLAY_SYSTEM_CONFIG_TABLE 

DISPLAY.TREE 

QUIT 

VALIDATE_GLOBAL_INFORMATION 
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ANALYZE _CDCNET_DUMP (ANACD) 

Purpose The ANALYZE _CDCNET_DUMP command begins a Dump Analyzer 
session on the host. 

Format ANALYZE _CDCNET_DUMP 

DUMP.JJLE = dump_file_name 
VERSION = dump _file _version JLevel 
INPUT = input Jile_name 
OUTPUT = output _file_name 
STATUS = status ^.variable _name 

Parameters DUMP_FILE (DF) 

This parameter specifies the name of the file containing the CDCNET DI 
dump to be analyzed. 

If the DUMP_FILE parameter is omitted, file name DUMPFIL is assumed. 
VERSION (V) 

This parameter specifies the version level of the Dump Analyzer to be used 
for analyzing the dump file. No radix can be specified on this parameter, it 
is simply entered as four hexadecimal digits. 

If the VERSION parameter is omitted, the Dump Analyzer version used is 
the one selected by the site administrator, usually the version level of the 
CDCNET software currently installed at the site. 

INPUT (I) 

This parameter specifies the name of the file (ASCII 6/12 on NOS) 
containing Dump Analyzer subcommands in SCL format. Under NOS/VE, 
this file is opened at the beginning- of-information (BOI) by default. Under 
NOS, this file must be local, and it is not rewound before it is read. 
If the INPUT parameter is omitted, file name $COMMAND (INPUT on 
NOS) is assumed. This file is usually attached to the terminal. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE, and 
should include file position if you want other than the default position, 
beginning-of-information (BOI). This file is local on NOS, where it is 
always positioned at the end-of-information (EOI). Output is written in 
ASCII format. 

During the Dump Analyzer session, output can be redirected for individual 
subcommands that have their own OUTPUT parameters. 
If the OUTPUT parameter is omitted, file name $OUTPUT (OUTPUT on 
NOS) is assumed. This file is usually attached to the terminal. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS 
the STATUS parameter is ignored. 
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Remarks • ANALYZE _CDCNET_DUMP is abbreviated ANACD. Under NOS/VE, 

either the full or abbreviated forms of the ANALYZE _CDCNET_DUMP 
command and its parameters may be used to begin a Dump Analyzer 
session. Only the abbreviated form of the command, and its parameters, 
may be used under NOS. 

• Under NOS/VE, Dump Analyzer error messages are always written to 
the file TERRORS, which is usually attached to your terminal. Under 
NOS, Dump Analyzer messages are always written to file OUTPUT. 
Under both operating systems, error messages are also written to the 
currently active output file, if this is not a terminal. 

NOTE 

The file named in an output parameter on a subcommand takes 
precedence over the output file named on the ANACD command during 
execution of that subcommand. 

Examples The following NOS command accepts subcommands from file CMDFILE and 
writes output to the terminal. 

ANACD ,DF=DIAA132 , I=CMDFILE 

The following NOS command begins an interactive Dump Analyzer session, 
specifying 2404 as the version of the Dump Analyzer to be used. 

ANACD, DF=DSA9189,V=2404 

The following NOS/VE command begins an interactive Dump Analyzer 
session on a dump file from SYSTEM _0800253000DA. 

ANACD , DF=$SYSTEM . CDCNET . DUMP . SYSTEM_0800253000DA . FULL_870 1 050856249 1 89 
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Initial output from the ANACD command contains the Dump Analyzer 
banner message, and is formatted as follows: 

COPYRIGHT CONTROL DATA SYSTEMS, INC. 1985, 1992 
ALL RIGHTS RESERVED 

CDCNET DUMP ANALYZER VERSION = 1614 

CDCNET DI SOFTWARE BOOT VERSION RECORDED IN MPB.RAM = 1614 

CDCNET DI SOFTWARE RELEASE LEVEL RECORDED IN SYSTEM.DATA = 1614 



The reset _code found In the dump file Is 

18(16) = TASK_ERROR_NO_RECOVERY_PROC 



NOTE 



In order to function properly, the Dump Analyzer must be able to locate 
and interpret certain data structures from the DI dump file. Because these 
data structures can change (in location or structure) from version to 
version, it is important to use a Dump Analyzer that can read the dump 
file under analysis. If you do not specify an alternative version of the 
Dump Analyzer, the version used is the version selected by your CDCNET 
site administrator. 

To help identify which alternative Dump Analyzer version should be used, 
two version numbers are displayed at the start of the Dump Analyzer 
session. One identifies the official release level of the CDCNET software 
product. This version number is stored into the DI's System Data Table 
during initialization. 

The other version number, the boot version, is stored in MPB RAM and 
identifies the software version of the boot file that is used to reload the 
DI. Unless your site develops software in conjunction with Control Data, 
the boot version number should match the release level version number. 

If the version level of the Dump Analyzer you are using does not match 
the release level version of the dump file, the Dump Analyzer displays 
diagnostic message number 86. You might find it necessary to restart the 
Dump Analyzer program and specify the CDCNET software version level of 
the dump file for the VERSION (V) parameter on the ANACD command. If 
a copy of the Dump Analyzer program built at this software version level 
is available at the site, it is used. 
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Summary of Subcommands 

Subcommands processed by the Dump Analyzer fall into six major categories, as 
summarized in the following table. 



Dump Analyzer 
Control Subcommand 



Description 



QUIT (QUI) 



Dump Analyzer 
Help Subcommands 



Terminates the Dump Analyzer 
session and returns control to the 
operating system. 



Description 



DISPLAY_COMMAND .INFORMATION 
(DISCI) 

DISPLAY_COMMAND_LIST (DISCL) 



HELP (HEL) 



Dump Summary Subcommands 



Displays parameter information for a 
specified Dump Analyzer subcommand. 

Displays a list of available Dump 
Analyzer subcommands. 

Displays a list of available Dump 
Analyzer subcommands, or parameter 
information for a specified Dump 
Analyzer subcommand. 

Description 



DISPLAY_AUTO_DUMP_TABLE (DISADT) 



DISPLAY_BOARD_MAP_TABLE (DISBMT) 



DISPLAY_DI .SYSTEM .STATUS (DISDSS) 



DISPLAY_EXECUTIVE .ERROR .TABLE 
(DISEET) 

DISPLAY.HARDWARE .STATUS (DISHS) 



DISPLAY.ICA.SYSTEM .STATUS (DISISS) 



DISPLAY.NETWORK .STATUS (DISNS) 



DISPLAY.SYSTEM .CONFIG .TABLE 
(DISSCT) 

VALIDATE .GLOBAL .INFORMATION 
(VALGI) 



Displays the contents of the auto 
dump table and the map of memory 
available in the dump file. 

Displays the contents of the board 
map table. 

Displays system configuration 
information from the time of reset. 

Displays information from the 
executive error table. 

Displays information about the 
modular DI hardware from the time of 
reset. 

Displays system configuration 
information from the time of reset. 

Displays status of networks connected 
to the DI at reset. 

Displays information from the system 
configuration table. 

Displays general diagnostic 
information, serving as a preliminary 
guide to further analysis. 
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Address-Oriented Subcommands 

DISPLAY_BUFFER_CHAIN (DISBC) 



Description 



DISPLAY_DATA_QUEUE (DISDQ) 



DISPLAY_LINKED_LIST (DISLL) 



DISPLAY_MEMORY (DISM) 



Displays buffer chain information 
starting from the specified machine 
address. All descriptor buffers or data 
buffers are displayed for all messages 
in the chain. 

Displays buffer chain information 
associated with the queue control 
block at the specified machine 
address. 

Displays a linked list of structured 
elements given the machine address of 
the first element and offset to a 
pointer within the structure linking it 
to the next item in the list. 

Displays memory contents. The 
display begins at a specified machine 
address or entry-point address and is 
of a specified length. Both 
hexadecimal and ASCII formats are 
displayed. 



DISPLAY_MEMORY_HEADER (DISMH) 



DISPLAY_TREE (DIST) 



Displays information from the 
allocation header of the memory 
extent that contains the specified 
address. 

Displays all nodes of a binary tree 
structure, or a specified node 
matching a user-supplied key. 
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Task-Oriented Subcommands 



Description 



DISPLAY_CALL (DISC) 



DISPLAY_MEMORY_USERS (DISMU) 



DISPLAY_TASK_CONTROL_BLOCK 
(DISTCB) 



SELECT_TASK (SELT) 



VALIDATE .STACK _AREAS (VALSA) 



Miscellaneous Subcommands 



Displays information about the 
dynamic call chain (or module 
traceback) of the specified task, or all 
tasks. 

Displays information about the 
allocation of memory extents to 
various tasks or other users in the 
system. 

Displays information from the task 
control block for the specified task, or 
all tasks. 

Specifies the task to be examined in 
subsequent task-oriented subcommands 
(designates the task to be considered 
the current task). 

Checks integrity of the reserved and 
user stack areas of any or all tasks. 

Description 



DISPLAY_LINE .CONTROL _BLOCK 
(DISLCB) 



DISPLAY_LOG_QUEUES (DISLQ) 



DISPLAY_MEMORY_MAP (DISMM) 



Displays information from the 
configured line control block for a 
given line, or all lines. 

Displays the preserve and 
initialization log message queues. 

Displays a memory map of the 
modules that were loaded in the DI 
before it was reset. 
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Subcommand Syntax and Conventions 

Following are descriptions of syntax and conventions for Dump Analyzer subcommands. 

Subcommand Entry 

• Subcommands and parameters may be specified either in their full or abbreviated 
forms on NOS/VE or NOS. 

• Under NOS/VE, Dump Analyzer subcommands can be continued from one line to 
the next according to standard SCL conventions. Under NOS, the Dump Analyzer 
processes exactly one subcommand per line. 

• Subcommand names are formed with a verb followed by an object (for example 
DISPLAY_BUFFER_CHAIN, where DISPLAY is the verb and BUFFER_CHAIN is 
the object). 

• Subcommand names may be abbreviated to the first three characters of the verb 
followed by the first character of each word in the object (for example, DISPLAY- 
DATA _QUEUE is abbreviated DISDQ). 

Parameter Specification 

• Subcommand parameters may be abbreviated to the first letter of each word (for 
example, DISPLAY_OPTION is abbreviated DO). However, the STATUS parameter 
(used under NOS/VE) must not be abbreviated. 

• Subcommand parameters may be specified by equating the parameter name with the 
desired value (such as DO=E), or they may be specified positionally, without the 
parameter name. 

If parameters are specified positionally, commas must be used to skip over omitted 
parameters (for example, DISM 256„16,4, where the second parameter is omitted). 
Otherwise, subcommand parameters may be separated by commas or spaces. 

Numeric Values 

• Numeric values for parameters are of the form nn(ra), where nn is a string of 
digits and ra is the radix. Valid radixes are 2, 8, 10, and 16. It is true for all 
numeric parameters that if no radix is specified, the radix 16 is assumed. 

Hexadecimal values starting with digits A through F must be preceded by zero, 
making them distinct from literals. (For example, 0FFF(16) is interpreted as a 
numeric, but FFF(16) is interpreted as a literal.) 

Integer values specified on parameters must be greater than zero, unless otherwise 
indicated in the subcommand format. 



• 



Address Values 

• Numerically expressed addresses must be integers in the range 0..7FFFFFFF(16). 
See the individual subcommands for alternatives to numeric expression. (For 
example, some parameters allow you to specify externally defined entry points by 
name, as in ADDRESS=major_card_status_table.) 
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File Name Values 

• File names specified on parameters may be up to 31 characters long under NOS/VE 
or NOS, but only the first seven characters. are used to determine the identity of 
the file if the Dump Analyzer is running under NOS. This permits you to use 
unchanged procedures or directives files on either operating system, even if they 
contain subcommands with long file names. The Dump Analyzer does not ensure 
that a long file name shortened for NOS is unique. 

Under NOS/VE, file names may begin with, and include anywhere in the name, the 
alphabetic characters A through Z or any of the four special characters in the set 
($, #, @i and _). NOS/VE file names may also include, but must not begin with, 
numerals. File names containing the special characters ($, #, @, and _) are only 
legal under NOS/VE. 

Under NOS, file names must begin with an alphabetic character, A through Z, but 
may include numerals. 

Boolean Values 

• Boolean parameters can be specified by any of their standard aliases. These are: 
TRUE/FALSE, YES/NO, and ON/OFF. 

STATUS Parameter 

• The STATUS parameter is operational only under NOS/VE. It is used to report 
errors. For a complete description of the STATUS parameter, see the NOS/VE 
System Usage manual. 

Under NOS, the STATUS parameter is checked for correct syntax (it must be a 
valid NOS name), but output is not otherwise affected by its use. 
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DISPLAY_AUTO_DUMP_TABLE (DISADT) 
ANACD Subcommand 

Purpose This subcommand displays the contents of the auto dump table. This 
display identifies the DI address ranges available in the dump file. 

Format DISPLAY_AUTO DUMP TABLE 

OUTPUT = file_name~ 
STATUS = status _variable _name 

Parameters OUTPUT (O) 

This optional parameter specifies the name of the file on which the 
information is to be written. If the output file name is not specified, 
information is written to the output file specified on the ANACD control 
statement. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Examples The DISADT subcommand shown below, produces an auto dump table 
display with the information written on the output file named ADT. 

DISADT 0=ADT 

Output from this subcommand is formatted as follows: 
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DISP1AY_AUT0_DUMP_TABLE (DISADT) 



AUtO 


Dump Table Checksum 


0D7E(16) 


AUtO 


Dump Table Address 


10B29E(16) 


AUtO 


Dump Table Byte Count 


: = 35A(16) 


Entry Start 


End 


Number 


Number Address 


Address 


of Bytes 


1 





678 


678 


2 


88E 


2EB4 


2626 


3 


2F72 


4000 


108E 


4 


90000 


96000 


6000 


5 


0A0000 


0A8000 


8000 


6 


100000 


10CAFO 


0CAF0 


7 


10D5A0 


10D930 


390 


8 


10D97C 


10DF92 


616 


9 


111ECE 


114696 


27C8 


10 


116C70 


1 17C2C 


0FBC 


11 


117DA8 


117FBC 


214 


12 


119C88 


11A67A ' 


9F2 


13 


11CA66 


11D9D6 


0F70 


14 


11ED22 


11FF18 


11F6 


15 


11FFFC 


12019E 


1A2 


16 


12025C 


120508 


2AC 


17 


1210E8 


121322 


23A 


18 


12362A 


124E82 


1858 


19 


124EA8 


125828 


980 


20 


125C9C 


125E8A 


1EE 



n nnnnnn nnnnnn nnnn 

where n is the total number of ADT entries. 
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DISPLAY_BOARD_MAP_TABLE (DISBMT) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



Remarks 



This subcommand displays selected fields of the board map table. This 
allows users to determine if a reset has occurred as a result of a hardware 
problem. 

DISPLAY_BOARDJVIAP TABLE 

OUTPUT = file_name 

STATUS = status _variable _name 

OUTPUT (O) 

This optional parameter specifies the name of the file on which the 
information is to be written. If the output file name is not specified, 
information is written to the output file specified on the ANACD control 
statement. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

If there are no error counts, then the field is left blank. The error type is 
displayed in the Error Description column (see the following example). 

Failing addresses are displayed in hexadecimal. All other integer values 
are displayed in decimal. 

If a slot is empty, the line for that slot is left blank. 
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DISPLAY_30ARD_MAP_TABLE (DISBMT) 

Examples The DISBMT subcommand shown below, produces a board map table with 
the information written on the output file named MAP. 

DISBMT 0=MAP 
Output from this subcommand is formatted as follows: 
BOARD MAP TABLE DISPLAY 
Conditions shown exist after reset 

Card Card Falling 

Slot Type OK Status Address Counts Error Description 






MPB 


Yes 






100AC 


3 Fatal Error 


1 


PIIM 


Yes 






15AC73 


17 Parity Error 


2 


SMM 


Yes 






200000 


5 Single-Bit Error 
2 Mult1-B1t Error 


3 


ESCI 


Yes 










4 














5 














6 


ESCI 


No 








Transceiver Bad 


7 


CIM 


Yes 










LIM 












Parent CIM 


Slot 


LIM Type 




LIM Status 


Slot 





RS232 


8-Channel 


Not 


tested 


$CIM 7 


1 


RS232 






OK 




M 


2 


URI 






Not 


tested 


H 


3 


X.24 






OK 




H 


4 


V.35 






Bad 




N 


5 
6 
7 


UNKNOWN 








It 

H 


RS449 






OK 




H 


NOTE 














In the case 


of MPA RAM, 


the failing address 


is biased by 8000(16). 
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DISPLAY_BUFFER_CHAIN (DISBC) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



This subcommand displays information from selected buffer chains starting 
from the specified machine address. Descriptor buffers are summarized and 
depending on the display option selected, data from the associated data 
buffers is displayed. 

DISPLAY_BUFFER _CHAIN 

ADDRESS = address or entry point name 

DISPLAY JOPTION = keyword 

REPEAT JCOUNT = integer < 4096 or ALL 

OUTPUT = file_name 

STATUS = status _variable _name 

ADDRESS (A) 

This required parameter specifies the starting address of the buffer chain 
to be displayed. The value may be a memory address or an entry point 
name (externally defined variable) whose address is used as the base 
address for the display. Entry point names are found by using the 
DISPLAY_MEMORY_MAP subcommand described in this chapter. 

DISPLAY JOPTION (DO) 

This parameter specifies the amount of data to be displayed. If FULL (or 
EXPANDED) is specified, the descriptors and data for all messages starting 
2£™« e address s P ecifie d to the end of the message chain are displayed. If 
BRIEF (or SUMMARY) is specified, only summary information indicating 
the starting address of the descriptor for each message chain, the number 
of buffers chained for each message, and the total characters in the 
message are displayed. 

If the DISPLAY_OPTION parameter is not specified, FULL is assumed. 
REPEAT JCOUNT (RC) 

This parameter indicates the number of messages to be displayed. If the 
value specified is greater than the number of message chains encountered 
all the message chains from the specified starting descriptor are displayed 
The keyword ALL also causes all the message chains from the specified 
starting descriptor to be displayed (up to a maximum of 4096 messages). 
If REPEAT_COUNT is not specified, all the message chains from the 
specified starting descriptor are displayed (up to a maximum of 4096 
messages). 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Remarks The data enclosed in brackets in the data buffer display is the area in use 
(see the example below). Data following the area in use is not displayed. 

Examples The DISPLAY_BUFFER_CHAIN subcommand, shown below, writes 

information from the buffer chain beginning at address 19188E(16) to the 
ANACD output file. 

DISPLAY_BUFFER_CHAIN ADDRESS=19188E 

Output from this subcommand is formatted as follows: 

BUFFER CHAIN DISPLAY 



DATA DESCRIPTOR 
NEXT.MESSAGE 
OFFSET 
COUNT.MESSASE 

USAGE COUNT 
DATA AT THE.DATA: 



19188E(16> 

0(16) 

5B(16) 

0BDO6) 

FFFF(16) 



18F3E4 
18F3F4 
18F404 
18F4 14 
18F424 
18F434 
18F444 
18F454 
18F464 
18F474 



FFFF 4552 

4F56 4552 

4F56 4552 

4F56 4552 

4F56 4552 

5010 132F 

0114 1337 

7300 1 154 

2020 2020 
2020] 



464C 
464C 
464C 
464C 
464C 
42C9 
2904 
4449 
2020 



4F57 
4F57 
4F57 
4F57 
4F57 
004E 
3000 
3131 
2020 



NEXT.DESCRIPTOR 
THE.DATA 
COUNT.BUFFER 
USAGE.DESCRIPTOR 



1A542206) 

18F3E4( 16) 

36(16) 

FFFF( 16) 



4F56 4552 464C 4F57 ERFLOWOVERFLOW 

4F56 4552 464C 4F57 OVERFLOWOVERFLOW 

4F56 4552 464C 4F57 OVERFLOWOVERFLOW 

4F56 4552 464C 4F57 OVERFLOWOVERFLOW 

4F56 4552 464C 4F57 OVERFLOWOVERFLOW 

0001 0008 [3501 0185 P /B N 5 

0000 0108 0025 1000 7) X 

3520 2020 2020 2020 s TDI1I5 

2020 2020 2020 2020 



DATA DESCRIPTOR 
NEXT.MESSAGE 
OFFSET 
C0UNT_MESSASE 

USAGE COUNT 
DATA AT THE.DATA: 



1A5422<16) 

0(16) 

H16) 

87( 16) 

FFFF(16) 



NEXT.DESCR1PTOR 
THE.DATA 
COUNT.BUFFER 
USA6E.DESCRIPT0R 



1A5896(16) 

121170(16) 

7B(16) 

FFFF( 16) 



121170 FFFF [OB01 01DA 0B01 01E0 0BO1 13A5 0A03 

121180 0000 0001 0A05 0800 2530 01 IB 0B01 01E1 SO 

121190 0A01 0010 124E 6465 666C 2C20 332C 2033 Nctefl, 3. 3 

121 1A0 2C20 6173 796E 6374 6970 2C20 6C69 6E65 . asynctip, line 

121 1B0 3333 2C20 4152 3D53 4350 2C20 6C74 3D73 33, AR=SCP, 1t=s 

1211C0 7769 7463 6865 642C 2063 6374 3D33 3630 witched. cct=360 

121 1D0 2C20 6364 743D 3132 302C 2074 7570 3D74 , cdt=120. tup=t 

1211E0 7570 7063 720B 0101 E20A 0180 EC] UPDOr 
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The following DISPLAY_BUFFER_CHAIN subcommand displays summary 
information for the buffer chains starting at address 18A0F0(16). 

DISBC A=18A0F0 DO=B 

Output from this subcommand is formatted as follows: 

BUFFER CHAIN DISPLAY 



STARTING ADDRESS NUMBER OF 

OF DESCRIPTOR BUFFERS 

MESSAGE # 1 18A0F0O6) 1 

MESSAGE (t 2 192539(16) 2B9 

MESSAGE # 3 1A37C806) 12B 



TOTAL CHARACTERS PER MESSAGE 
(COUNT_MESSAGE) 

2A(16)= 42(10) 

8E86(16)= 36486(10) 

3547BC(16)= 491772(10) 



If you want, the DISPLAY_BUFFER_CHAIN subcommand could next be 
used to display the data in the buffer chains for particular messages by 
using the addresses given above, a REPEAT_COUNT restriction, and the 
DO = FULL option. 

Message chains that contain zero byte buffers or invalid buffer _count data 
are flagged with an alert following the message summary line, as in the 
following example: 



MESSAGE # 7 1E0OA2(16) 1C 24F(16)= 1103(10) 

•*** ZERO BYTE BUFFER ENCOUNTERED IN PRECEDING MESSAGE 
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DISPLAY_CALLS (DISC) 
ANACD Subcommand 

Purpose The DISPLAY_CALL subcommand displays information about nested 

procedure calls for a specified task or for all tasks in the dump file. The 
display is ordered from the most recent call to the least recent call. The 
module name and the name of the nearest entry point preceding the 
address of interest in that module are displayed. 

Format DISPLAY.CALL 

TASK JDENTWIER = address, task_name or keyword 

REPEAT JCOUNT or COUNT = integer 1.A096 or keyword 

START = integer 1..4096 

STACK JFRAME = boolean 

OUTPUT = file_name 

STATUS = status ..variable _name 

Parameters TASK IDENTIFIER (TI) 

This parameter specifies the Task Control Block (TCB) address for the task 
to be examined. If a task name is specified, call information is displayed 
for all the TCBs scheduled for that task. The keyword ALL causes all 
tasks to be processed, beginning with the system ancestor task. 

If TASK .IDENTIFIER is omitted, only the currently selected task is 
processed. The currently selected task is the task specified on the 
SELECTJEASK subcommand. If SELECTJEASK has not been used to 
specify a task, the task running when the DI was reset is assumed. If no 
task was running when the DI was reset, the Dump Analyzer issues 
diagnostic message number 37. 

REPEAT JCOUNT (RC) or COUNT (C) 

This parameter specifies the number of calls to be displayed. If the 
keyword ALL is specified, or if REPEAT_COUNT is greater than the 
number of existing calls, all calls from the specified starting call are 
displayed (up to a maximum of 4096 calls). 

If COUNT is omitted, all calls from the specified starting call are 
displayed (up to a maximum of 4096 calls). 

START (S) 

This parameter specifies which call on the chain is to be displayed first. 
This parameter makes it possible to eliminate display of the most recent 
calls. The value 1 represents the most recent call, 2 represents its 
predecessor, and so forth. For example, S=5 causes the display to begin 
with the fifth most recent call. 

If START is omitted, display begins with the most recent call. 

STACK _FRAME (SF) 

This parameter specifies whether the stack frame(s) associated with the 
call should be displayed. Addresses within a stack frame display are 
expressed as offsets from the stack frame's starting address. For 
SF=TRUE (ON or YES), all stack frames are displayed; for SF= FALSE 
(OFF or NO), no stack frames are displayed. 

If STACK _FRAME is omitted, no stack frames are displayed. 
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Remarks 



Examples 



OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

If module and entry point information is not available in the dump file, 
only the absolute address for the specified call or calls is displayed. 

The following subcommand displays five calls, starting with the third most 
recent call in the call chain for the currently selected task. 

DISPLAY.CALL START=3 REPEAT_COUNT=5 



or 



DISC S=3 RC=5 



Output from the DISPLAY_CALL subcommand is displayed in one of the 
following three formats. 

1. If module and entry point information is available: 

TCB ADDRESS 1044D6(16) 

TRACEBACK FROM MODULE EXEC.PMM + 142(16) 
NEAREST PRECEDING ENTRY POINT CALL_SURE_BG 

CALLED FROM - MODULE SYSTEM_ANCESTOR + 1 FCC (16) 
NEAREST PRECEDING ENTRY POINT RESET_DI 

CALLED FROM - MODULE SYSTEM.ANCESTOR + 458(16) 
NEAREST PRECEDING ENTRY POINT SYSTEM_ANCESTOR 

2. If module and entry point information is not available: 

TCB ADDRESS 13BA96(16) 

Traceback from address 100FC6O6) 

Called from - address 101234(16) 

Called from - address 1010C8O6) 



19-18 CDCNET Commands 



60000414 C 



DISPLAY.CALLS (DISC) 



3. If stack frame display is requested (that is, SF=TRUE): 



TCB ADDRESS 



139244(16) 



TRACEBACK FROM MODULE EXEC.PMM ♦ 142(16) 
NEAREST PRECEDINS ENTRY POINT CALL .SURE _BG 

STACK FRAME STARTING AT 1BD06O6) AND ENDING AT 1BD9K16) 

01 23 45 67 89 A B CD EF 



1BD06 
1BD16 
1BD26 
1BD36 
1BD46 
1BD56 
1BD66 
1BD76 
1BD86 



0001 BD92 0015 395C 0000 0052 0008 0002 
3135 3A30 323A 3533 5354 4143 0008 0002 
3131 2F32 312F 3836 5354 4143 4B20 O0E4 
5354 0000 0027 2A20 4449 2052 6573 6574 
2C20 536F 6674 7761 7265 2045 7272 6F72 
2043 6F64 6520 3D20 2033 3220 2A20 2020 
2020 2020 2020 2020 2020 2020 2020 2020 
2020 2020 2020 2020 2020 2020 2020 2020 
2020 2020 20DE FF01 BDA4 0001 



9\ R 
15:02:53STAC 
11/21/86STACK 
ST '* DI Reset 
, Software Error 
Code = 32 « 



CALLED FROM - MODULE SYSTEM.ANCESTOR * 222C06) 
NEAREST PRECEDING ENTRY POINT RESET.DI 

STACK FRAME STARTING AT 1BD92( 16) AND ENDING AT 1BDA306): 

01 23 45 67 89 AB CD EF 

1BD92 0001 BDA4 0001 2596 0000 0032 FF83 0024 X 2 $ 
1BDA2 9864 d 

CALLED FROM - MODULE COMMON_CYB1L.SUBROUTINES.PMM ♦ 2AA(16) 
NEAREST PRECEDING ENTRY POINT ABORT.SYSTEM 

STACK FRAME STARTING AT 1BDA4U6) AND ENDING AT 1BDB9(16) : 

01 23 45 67 89 AB CD EF 



1BDA4 0001 BDBA 0027 85EA 0000 0032 001F B9DA 
1BDB4 001F 985E 0024 



CALLED FROM - MODULE EMAL.TEST ♦ 32( 16) 
STACK FRAME STARTING AT 1BDBA( 16) AND ENDING AT 1BDF906) 
01 23 45 67 89 AB CD EF 



1BDBA 0001 BDFA 0027 9D4C 001F B9DA 001F 0011 

1BDCA 152C 001F B4EA 4143 4B20 0OF8 5354 0024 

1BDDA 985E 0024 9864 0024 97CC 0024 9864 0043 

1BDEA 0120 OOFB 0024 97C6 0000 0000 5354 4143 



' L 

ACK ST S 

$ d $ $ d C 

$ STAC 



CALLED FROM - MODULE EMAL.TEST ♦ 1794(16) 
NEAREST PRECEDING ENTRY POINT EMAL.7 

STACK FRAME STARTING AT 1BDFA(16) AND ENDING AT 

01 23 45 67 89 AB CD EF 

1BDFA 0001 BDFE 



1BDFD( 16) 



CALLED FROM - MODULE OLL_PROGRAM.INTERFACE_PROCS ♦ 171A(16> 
NEAREST PRECEDING ENTRY POINT START.NAMED.TASK.AND.PRXEED 
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DISPLAY_COMMAND .INFORMATION (DISCI) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



Examples 



The DISPLAY.COMMAND .INFORMATION subcommand displays a list of 
parameters associated with a given Dump Analyzer subcommand, including 
types and default values. This subcommand displays information in the 
same format as the CDCNET and NOS/VE commands of the same name. 

NOTE 



The description below applies only to DISPLAY_COMMAND 
INFORMATION on NOS. If you are using the Dump Analyzed under 
NOS/VE, the SCL DISPLAY_COMMAND .INFORMATION command 
supplies similar information. (See the NOS/VE System Usage manual.) 



DISPLAY.COMMAND .INFORMATION 
COMMAND .NAME = name 
OUTPUT = file _name 
STATUS = status _variable _name 

COMMAND _NAME (CN) 

This parameter specifies the name of the Dump Analyzer subcommand for 
which parameter information is to be displayed. The value may be the full 
name of a Dump Analyzer subcommand, or any of its valid abbreviations. 

This parameter is required. If the specified subcommand name cannot be 
found, a warning is issued with no further display. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid NOS file name. This file is 
local. 

If OUTPUT is not specified, the output file name on the ANACD command 
is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

The following subcommand displays subcommand information for the 
DISPLAY.CALL subcommand: 

DISCI DISC 
Output from this subcommand is formatted as follows: 



TASK_IDENTIFIER, TID, TI 

COUNT, C, REPEAT.COUNT, RC 

START, S 

STACK.FRAME, SF 

OUTPUT, 

STATUS 



any - Soptlonal 

integer 1 .. 0FFFO6) or key ALL « ALL 

Integer 1 . . 0FFF(16) = 1 

boolean - FALSE 

name = Soptlonal 

name - Soptlonal 
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DISPLAY_COMMAND_LIST (DISCL) 
ANACD Subcommand 

Purpose The DISPLAY_COMMAND_LIST subcommand displays the list of 

subcommands that are currently available for execution by the Dump 
Analyzer. This command is patterned after the CDCNET command by the 
same name. 



NOTE 



The description below applies only to DISPLAY_COMMAND_LIST on 
NOS. If you are using the Dump Analyzer under NOS/VE, use the SCL 
DISPLAY_COMMAND_LISTJBNTRY command for similar information. 
(See the NOS/VE System Usage manual.) There are differences in the 
output format between the Dump Analyzer's DISCL command and the SCL 
DISCLE command. 

Format DISPLAY.COMMAND _LIST 

DISPLAY _OPTION=keyword 

OUTPUT = file _name 

STATUS = status _variable _name 

Parameters DISPLAY JOPTION (DO) 

This parameter specifies the detail of information to be displayed. If the 
keyword FULL (F, EXPANDED, E, or ALL) is specified, all commands are 
listed both by their complete names and by any abbreviated forms. If the 
keyword BRIEF (B, SUMMARY, or S) is specified, then a list is displayed 
that gives only the full name of each subcommand. 

If the DISPLAY_OPTION parameter is not specified, subcommand names 
are displayed in the BRIEF format. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 

output is written. This file may be any valid NOS file name. This file is 

local. 

If OUTPUT is not specified, the output file name on the ANACD command 

is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Remarks The HELP subcommand, with no parameters, results in the same output as 
display _command_list do=b. 
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Examples The following subcommands display a list of the available Dump Analyzer 
subcommands in BRIEF mode: 

or DISCL 

DISCL DO=B 

Output from this subcommand is formatted as follows: 

ANACD COMMAND LIST 



DISPLAY_AUTO_DUMP_TABLE 

DISPLAY_BUFFER_CHAIN 

DISPLAY_COMMAND_INFORMATION 

DISPLAY_DATA_QUEUE 

DISPLAY_EXECUTIVE_ERROR_TABLE 

DISPLAY_LINKED_LIST 

DISPLAY_LOG_QUEUES 

DISPLAY_MEMORY_HEADER 

DISPLAY_MEMORY_USERS 

DI SPLAY_PROGRAM_VALUE 

0ISPLAY_TASK_C0NTROL_BLOCK 

HELP 

SELECTJTASK 

VALI DATE_STACK_AREAS 



DI SPLAY_BOARD_MAP_TABLE 

DISPLAY_CALLS 

DISPLAY_COMMAND_LIST 

DISPLAY_DI_SYSTEM_STATUS 

DISPLAY_HARDWARE_STATUS 

DISPLAY_LINE_CONTROL_BLOCK 

DISPLAY_MEMORY 

DISPLAY_MEMORY_MAP 

DISPLAY_NETWORK_STATUS 

DISPLAY_SYSTEM_CONFIG_TABLE 

DISPLAY_TREE 

QUIT 

VALIDATE_GLOBAL_INFORMATION 
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The following subcommand displays a list of the Dump Analyzer 
subcommands in FULL format. 

disci do»f 

Output from this subcommand is formatted as follows: 

ANACD COMMAND LIST 



DISPLAY_AUTO_DUMP_TABLE 

DISPLAY_BOARD_MAP_TABLE 

DISPLAY_BUFFER_CHAIN 

DISPLAY_CALLS 

DISPLAY_COMMAND_INFORMATION 

DISPLAY_COMMAND_LIST 

DISPLAY_DATA_QUEUE 

DISPLAY_DI_SYSTEM_STATUS 

DI SPLAY_EXECUTIVE_ERROR_TABLE 

DISPLAY_HARDWARE_STATUS 

DISPLAY_LINKED_LIST 

DISPLAY_LINE_CONTROL_BLOCK 

DISPLAY_LOG_QUEUES 

DISPLAYJAEMORY 

DISPLAY_MEMORY_HEADER 

DISPLAYJAEMORYJAAP 

DI SPLAY.MEMOR Y_USERS 

DISPLAY_NETWORK_STATUS 

DISPLAY_PROGRAM_VALUE 

DISPLAY_SYSTEM_CONFIG_TABLE 

DISPLAY_TASK_CONTROL_BLOCK 

DISPLAY.TREE 

HELP 

QUIT 

SELECT.TASK 

VALIDATE_GLOBAL_INFORMATION 

VALIDATE_STACK_AREAS 



DISADT 

DISBMT 

DISBC 

DISPLAY_CALL,DISC 

DISCI 

DISCL 

DISDQ 

DISDSS 

DISEET 

DISHS 

DISLL 

DISLCB 

DISLQ 

DISM 

DISMH 

DISMM 

DISMU 

DISNS 

DISPV 

DISSCT 

DISTCB 

DIST 

HEL 

QUI 

SELT 

VALGI 

VALSA 
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DISPLAY JDATA .QUEUE (DISDQ) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



The DISPLAY_DATA_QUEUE subcommand displays information about the 
specified queue control block (QCB) and the buffer chains to which it 
points. 

DISPLAY_DATA _QUEUE 

ADDRESS = address or entry point name 

DISPLAYJOPTION = keyword 

REPEAT _COUNT = integer 1..4096 or keyword 

OUTPUT = file_name 

STATUS = status _variable _jiame 

ADDRESS (A) 

This required parameter specifies the starting address of the buffer chain 
to be displayed. The value may be a memory address or an entry point 
name (externally defined variable) whose address is used as the base 
address for the display. 

DISPLAY JDPTION (DO) 

This parameter specifies the amount of data to be displayed. If FULL (or 
EXPANDED) is specified, the descriptors and data for all messages in the 
queue are displayed. If BRIEF (or SUMMARY) is specified, only summary 
information indicating the starting address of the descriptor for each 
message chain, the number of buffers chained for each message, and the 
total characters in the message are displayed. 

If the DISPLAY_OPTION parameter is not specified, FULL is assumed. 
REPEAT JOOUNT (RC) 

This parameter specifies the number of messages to be displayed If the 
keyword ALL is specified, or if REPEAT_COUNT is greater than the 
number of existing messages, all messages from the specified starting 
descriptor are displayed (up to a maximum of 4096 messages). 
If REPEAT_COUNT is omitted, all message chains from the specified 
starting descriptor are displayed (up to a maximum of 4096 calls). 

OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples The following subcommand writes information for the QCB located at 
address 175242(16) into the file OUTFILE. 

DISPLAY_DATA_QUEUE ADDRESS= 175242 OUTPUT=OUTFILE 

or 



DISDQ A= 175242 0=OUTFILE 
Output from this subcommand is formatted as follows: 



QUEUE CONTROL BLOCK DISPLAY 



QCB ADDRESS 
LENSTH 
COUNT 
QNEXT 
QLAST 



{ LENGTH OF QUEUE ) 

{ NUMBER OF ENQUEUES } 

{ ADDRESS OF FIRST ENTRY IN QUEUE ) 

{ ADDRESS OF LAST ENTRY IN QUEUE } 



QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE > 



175242( 16) 

279(16) 

1A1B06) 

1A687806) 

1A37C8U6) 

0(16) 



BUFFER CHAIN DISPLAY 

DATA DESCRIPTOR 
NEXT.MESSABE 
OFFSET 
C0UNT_MESSA6E 

USA6E COUNT 
DATA AT THEJ3ATA: 



1A6878(16) 

192539(16) 

4F(16) 

7F(16) 

FFFF(16) 



NEXTJDESCRIPTOR 
THE.DATA 
COUNT.BUFFER 
USASE.DESCRIPTOR 



1151CE(16) 

122872(16) 

42( 16) 

FFFF(16) 



122872 FFFF 2020 2020 2020 2020 2020 2020 2000 

122882 0000 0020 2020 2000 0000 0020 2020 2020 

122892 2020 2020 2020 2020 2020 2020 2020 2000 

1228A2 0000 0020 2020 2000 0000 0020 2020 2020 

1228B2 2020 6465 666C 2C20 362C 2031 2C20 6173 

1228C2 [5010 132F 42C9 0012 0001 0008 3501 0185 

1228D2 0114 1336 1426 8000 0000 0108 0025 1000 

1228E2 7302 5D54 4449 3131 3520 2020 2020 2020 

1228F2 2020 2020 2020 2020 2020 2020 2020 2020 

122902 2020] 



defl, 6, 1, as 
P /B 5 

6 & X 
S ]TDI115 



DATA DESCRIPTOR 
NEXT.MESSAGE 
OFFSET 
COUNT.MESSABE 

USAGE COUNT 
DATA AT THE.DATA: 



1151CE(16) 

0(16) 

1(16) 

3D(16) 

FFFF( 16) 



NEXT.DESCR1PTOR 
THE.DATA 
C0UNT.BUFFER 
USAGE.DESCRIPTOR 



18FB2A(16) 

1151F406) 

3D(16) 

FFFF(16) 



1151F4 FFFF [0B01 02A4 1216 4641 494C 5552 455F FAILURE. 

115204 4D41 4E41 4745 4D45 4E54 5F42 4153 451A MANAGEMENT.BASE 

115214 1F00 0000 001A 1F00 0000 001A 1F00 0000 

115224 001A 1F00 0000 000A 0100 010A 0113 02] 



The rest of the data for this message is displayed, then all other messages 
in the queue follow. 
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The following subcommand displays summary information for the QCB 
located at address 175242(16). 

DISDQ A= 175242 DO=B 

Output from this subcommand is formatted as follows: 

QUEUE CONTROL BLOCK DISPLAY 



QCB ADDRESS 
LENGTH 
COUNT 
QNEXT 
QLAST 
QCHARACTERS 



{ LENGTH OF QUEUE } 

{ NUMBER OF ENQUEUES } 

{ ADDRESS OF FIRST ENTRY IN QUEUE } 

{ ADDRESS OF LAST ENTRY IN QUEUE } 

{ NUMBER OF CHARACTERS IN QUEUE } 



175242(16) 

279(16) 

1A1B(16) 

1A6878(16) 

1A37C8( 16) 

0(16) 



STARTING ADDRESS 
OF DESCRIPTOR 



MESSAGE # 1 
MESSAGE # 2 
MESSAGE # 3 



175242(16) 
192539(16) 
1A37C8( 16) 



NUMBER OF TOTAL CHARACTERS PER MESSAGE 

BUF FERS ( COUNT_MESSAGE ) 

1 2A(16)= 42(10) 

2B9 8E86(16)= 36486(10) 

12B 3547BC(16)= 491772(10) 



If you want, the DISPLAY.BUFFER .CHAIN command could next be used 
to display the data in the buffer chains for particular messages by using 
the addresses given above, or DISDQ could be used with the DO = PULL 
option to display the data for all the messages. 

Message chains that contain zero byte buffers or invalid buffer _count data 
are flagged with an alert following the message summary line, as in the 
following example: 

MESSAGE # 7 1EO0A2(16) 1C 24F(16)- 1103(10) 

**** ZERO BYTE BUFFER ENCOUNTERED IN PRECEDING MESSAGE 
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DISPLAY_DI .SYSTEM .STATUS (DISDSS) 
ANACD Subcommand 

Purpose This subcommand displays system configuration information. Its display is 

similar to that of the command by the same name that can be sent 
through the Network Operator Utility (NETOU) to active DIs. 

NOTE 

This subcommand applies to the ICA-II as well as the DI. You may also 
display ICA-II system configuration information by entering the DISPLAY.. 
ICA_SYSTEM_ STATUS (DISISS) subcommand, an alias for the DISDSS 
subcommand. DISISS is described in this chapter. 

Format DISPLAY.DI .SYSTEM .STATUS 

OUTPUT = file_name 
STATUS = status _variable _name 

Parameters OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Examples The following subcommand writes DI system status information to file 
STOUT. 

DISPLAY_DI_SYSTEM_STATUS OUTPUT-STOUT 
or 

DISDSS 0=STOUT 

Output from this subcommand is formatted as follows: 

DISPLAY DI SYSTEM STATUS 



System name ■ MDIJ5C 
System identifier ■ 080025 10008C( 16) 
Release level ■ 2404 
Boot version » 2404 
DI loaded from MCI board in slot 7 



Master clock * FALSE 
Number of tasks * 57 
CPU utilization * 11 * 
Helping system = 080025000107(16) 



Buffers 

Data 
Desc 



free 
1748 
654 



total 

2102 

700 



size 

144 
32 



State is GOOD 



Memory (2 MB Configuration) 

free fragments deloadable 

MPB 540 1 

PMM 3392 5 

SMM 227710 78 69576 

RESERVED 1000 1 N/A 

50X of memory after configuration made into buffers 
Largest SMM memory fragment available * 210040 



State is GOOD 
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Remarks The following definitions apply to the DISDSS display: 
System Name 



System Identifier 

Release Level 
Boot Version 



Master Clock 

Number of Tasks 
CPU Utilization 
Helping System 
Buffers 



Configuration file name of the DI (from 
DEFINE .SYSTEM command). 

12- digit hexadecimal system identifier associated 
with the DI. 

Level at which the software was compiled. 

Software version number specified in the 
exception list file (on the INITMDI command for 
NOS MDIs, and DEFES or DEFBD in exception 
file for other DIs). 

Indicates whether this DI maintains the 
network's master clock. 

Number of tasks executing in the DI. 

Percentage of time the CPU is active. 

DI system that facilitated last reload. 

Data. Buffer used to store user data. A 
configurable percentage of data buffers is 
allocated when the DI is initialized. 

Descriptor. Buffer used to keep track of data 
buffer information, such as chaining, usage 
counts, and so on. 

Free. Number of allocated buffers not currently 
in use. 

Total. Total number of buffers that are allocated 
for use by the DI. 

Size. Size in bytes of the buffer type (set by 
DEFINE _SYSTEM command). 
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Memory 



Buffer/Memory State 



MPB. System memory that resides on the MPB 
board. 

PMM. System memory that resides on the PMM 
board. 

SMM. System memory that resides on the SMM 
board. 

Reserved. Used by the Executive to communicate 
with other executive services when there is no 
other memory available. 

Free. Amount of system main memory that is 
currently available for modules to be loaded 
into. 

Fragments. Number of segments of available 
memory. 

Deloadable. Memory taken up by nonactive tasks 
that can be used when memory space becomes 
critically short. 

Four states indicating the relative availability of 
buffers and memory in the DI: GOOD, FAIR, 
POOR, and CONGESTED. The boundaries 
between these states are set during 
configuration (DEFINE _SYSTEM command). 
Each boundary is expressed as a percentage of 
the total resource allocated after DI 
configuration. 



60000414 C 



DI Dump Analyzer Commands 19-29 



DISPLAY_gXECUTIVE _ERROR_TABLE (DISEET) 



DISPLAY_EXECUTIVE JERROR JTABLE (DISEET) 
ANACD Subcommand 

Purpose This subcommand displays information from the executive error table. 

Format DISPLAY_EXECUTIVE ERROR TABLE 

OUTPUT = file_name 

STATUS = status ^variable _name 

Parameters OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Examples The following subcommand writes executive error table information to file 
EXEET. 

DISPLAY_EXECUTIVE_ERROR_TABLE OUTPUT=EXEET 

Display from this subcommand is formatted as follows. Refer to the 
Remarks following this display for explanations of some of the fields. 

EXECUTIVE ERROR TABLE DISPLAY 

Stopped by module EXEC_PMM ♦ 312 (16), supervisor stack ■ 3EF0 (16) 
SMM error count by slot • [0, 0, 1,2, 0, 0, 0] 
MPB status register shows battery low warning 
Number of spurious interrupts • 2 

Error # 1: privilege violation 
Milliseconds since error » 512 

0PERAT0R.SUPP0RT.APPL1CATI0N ♦ 3E0(16) Task 1s in user state 
Running task identifier = 102FE0O6) Supervisor stack * 3ED2 (16) 

Registers at time of error 

D0-D7 00000000 00000001 00000000 00004A7A 000OFFFF 00000001 0000FFFF 0016A084 
A0-A7 001ADB14 00000C76 00000020 00000000 00010000 001AD0AE 001AOA70 001ADA6C 

Error # 2: bus error 

Milliseconds since error • 1498 

0PERAT0R.SUPP0RT.APPLICAT10N ♦ 3E0(16) Task is in user state 

Running task identifier » 102FE0O6) Supervisor stack » 3ED2(16) 

Instruction register « 4E20(16) Access address * 102555(16) 

MPB status register shows parity error First failure addr » 102553(16) 

Access code = pmm bus Access type - Read 1o 

Registers at time of error 

D0-D7 00000000 454C4C45 4E2C0063 616E0059 4F550068 65617200 6D653F00 00000000 
A0-A7 001CCB12 00102555 00000000 00000000 00000000 001EF7AE 001CCEFO 001AEAEC 

Error # 3: srnm double bit error 
Milliseconds since error = 2560 

0PERAT0R.SUPP0RT.APPLICATI0N ♦ 3E0O6) Task is 1n supervisor state 
Running task identifier - 102FE0O6) User stack « 10EO2 (16) 
SMM (slot 2) error log - 3A4F(16) Slot 7 was accessing SMM 

Registers at time of error 

D0-D7 00000000 00000054 656C6C00 6D650069 66004927 60007361 6E652E00 41524259 
A0-A7 001AOB14 00000C76 00000020 00000000 00010000 001AD0AE 001ADA70 001ADA6C 
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Remarks Lines 1 through 4 of the executive error table display are written only if 
they apply to conditions at the time of the dump. 

Line 3 of the display, if written, can indicate any of the following warnings 
from the MPB status register: 

• Battery low • Temperature shutdown 

• Temperature high • AC low 

The first line of information about an error indicates one of the following: 

• Bus error • Bad status register 

• Address error • SMM single-bit error 

• Illegal instruction • SMM double-bit error 

• Zero divide • SMM detected bus parity error 

• Check instruction • Task runs too long 

• Arithmetic overflow • XX, an unrecognized code 

• Privilege violation 

The third line of information about an error indicates whether the task in 
error was in user or supervisor state. 

Up to four errors are displayed, in chronological order from the most 
recent to the least recent. 

NOTE ; 

The DISPLAY_EXECUTIVE_ERROR_TABLE subcommand displays the 
errors in chronological order even though the order of the error buffers in 
the executive error table data structure is not necessarily chronological. 

Error #2 in the example on the preceding page shows the format of an 
additional display line for address or bus errors. This additional line is 
formatted as follows: 

Instruction register = xxxx(16) Access address = xxxxxxxx(16) 

For bus errors, the MPB status register is examined and a line is 
displayed that reports the first failure address and whether the error was 
dtack_time_out, bus_lock_time_out, or parity _error. If the error was due 
to parity or dtack_time_out, the access code and type fields from the MPB 
status register are also extracted and displayed, as in Error #2 from the 
preceding example. 

Error #3 in the preceding example shows the format of an additional 
display line for SMM single- or double-bit errors. This additional line is 
formatted as follows: 

SMM (slot xx) error log = xxxx(16) Slot xx was accessing SMM 
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MPB-II Bus Error Recovery Register 

The MPB-II bus error recovery register, that may be displayed when a bus error has 
caused a DI reset, has a 16-bit register with the following title: 

Bus err recovery reg=xxxx(16) 

The bits in this entry are shown in the following table: 

Bit Description 



Bit 15 Error during access to local MPB-II 

Bit 14 Error during access to Internal Transfer Bus 

Bit 13 Error during write 

Bit 12 Error during interrupt acknowledge cycle 

B ft 11 Data acknowledge timeout 

Bit 10 Unused 

Bit 9 Internal Transfer Bus read parity error 

Bit 8 Unused 

B it 7 Unused 

Bi t 6 Unused 

Bit 5 Unused 

Bit 4 Bus grant timeout (BGTO) 

Bits 3_0 Hexadecimal address of card that was bus master. Valid 

only during BGTO. 
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DISPLAY.HARDWARE _STATUS (DISHS) 
ANACD Subcommand 

Purpose This subcommand displays information about the state and status of the 
hardware installed in the DI when the DI reset. Its display is similar to 
that of the command by the same name that can be sent through the 
Network Operator Utility (NETOU) to active DIs. 

Format DISPLAY.H ARDWARE J3TATUS 

DEVICE JVAME - name or keyword 
DISPLAY JOPTION = keyword 
OUTPUT = file_name 
STATUS = status ..variable _name 

Parameters DEVICE J^AME (DN) 

This parameter specifies the name of the LIM board or the ICA hardware 
for which information is to be displayed. When specifying a LIM, device 
names are of the form $nnnnx where nnnn is a 3- or 4-character 
alphabetic board name, and x is a single- digit board slot number. For 
example, the LIM in slot 7 would be entered $LIM7. If a LIM is specified 
with this parameter, then only status for that LIM is displayed. 

To display the ICA hardware status, enter $ICA_II to display ICA_II 
hardware. Enter $ICA_ICI to display the ICA_II channel interface. Enter 
$ICA_IEI to display the ICA_H Ethernet Interface. 

If no DEVICE _NAME is specified, if DN=ALL, or if the specified 
DEVICE _NAME is not recognized, then the status of all major boards and 
LIMs is displayed. 

DISPLAY JOPTION (DO) 

This parameter indicates the extent of the data to be displayed. If the 
keyword BRIEF (B, SUMMARY, or S) is specified, summary information is 
displayed for all major boards and only basic summary information on LIM 
status is displayed. If the keyword FULL (F, EXPANDED, or E) is 
specified, expanded status information is displayed for the LIMs, in 
addition to the basic display. 

If the DISPLAY_0PTI0N parameter is not specified, then BRIEF is used. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples The following examples are produced when displaying the LIM hardware 
status. 

The following subcommand displays a brief summary of DI LIM hardware 
status: 

DISPLAY_HARDWARE_STATUS DISPLAY_OPTION=BRIEF 
or 



DISHS DO=B 
Output from this subcommand is formatted as follows: 

DI HARDWARE STATUS 



Slot 



Card Card Boot 

type ok enabled State 



Version ROM Dump 
Status (16) level address (16) 





1 

2 
3 

4 
5 


MPB 
PMM 
SMM 
SMM 
CIM 
EMPTY 


yes 
yes 
yes 
yes 
yes 


no 
no 
no 
no 
no 


on 
on 
on 
on 
on 


configured 
configured 
configured 
conf igured 
configured 



8 
2 




50C 

50C 



50C 




10000 

100000 

200000 

80000 


6 

7 


ESC1 
MCI 


yes 
yes 


no 
yes 


on 
on 


not config 
active 






806 
50C 


A0000 
B0000 


Line 


Interface Modules 














Slot 




State 




Status 


Parent CIM 


LIM Type 







on 
on 
on 
on 
on 



configured 
configured 
configured 
conf igured 
conf igured 



on not config 



$CIM4 
$CIM4 
SCIM4 
$CIM4 
SC1M4 



SCIM4 



rs232 

rs232 

rs232 

rs232 

rs232 

lim_slot_empty 

lim_s lot .empty 

rs449 



If DO = FULL is selected, then, in addition to the above output, expanded 
LIM status is shown in the following format: 

Expanded LIM status 



LIM 1 


»ORT J 


State 


Status 


Protocol 


Line Name 








on 


enabled 


ASYNC 


LINEOO 




1 


on 


enabled 


ASYNC 


LINE01 




2 


on 


enabled 


ASYNC 


LINE02 




3 


on 


enabled 


ASYNC 


LINE03 


1 





on 


enabled 


ASYNC 


LINE 10 




1 


on 


enabled 


ASYNC 


LINE 11 
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If DEVICE _NAME=$LIM1 and DISPLAY_OPTION=FULL, then the 
following is displayed: 

DI HARDWARE STATUS 

Line Interface Modules 

Slot State Status Parent CIM LIM Type 

1 on configured $CIM4 rs232 

Expanded LIM status 



LIM 


PORT 


State 


Status 


Protocol 


Line Name 


1 





on 


enabled 


ASYNC 


LINE 10 




1 


on 


enabled 


ASYNC 


LINE 11 




2 


on 


enabled 


ASYNC 


LINE12 




3 


on 


enabled 


ASYNC 


LINE 13 



If DN=$LIM1 and DO = BRIEF, then only the following is displayed: 
DI HARDWARE STATUS 
Line Interface Modules 

Slot State Status Parent CIM LIM Type 

1 on configured $CIM4 rs232 

Examples The following examples are produced when displaying the ICA_II hardware 
status. 

The following subcommand displays the default value which is reported for 
the ICA_II as one board in slot 0. 

DISHS 

Output from this subcommand is formatted as follows: 

Card Card Boot version ROM Dump 

Slot type ok enabled State Status (16) level address (16) 

$ICA yes n/a on configured N/A 

If the DN=$ICA, the following output is displayed: 
DI HARDWARE STATUS 

Device Name Port State Status 

$ICA on configured 
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If the DN=$ICA_ICI, the following output is displayed: 

DI HARDWARE STATUS 

ICA-II Channel Interface Status 



Device Name Port State Status 

$ICA_ICI on configured 

If DN=$ICA_IEI is entered, the following output is displayed: 
DI HARDWARE STATUS 
ICA-II Ethernet Interface Status 



Device Name Port State Status 

$ICA_IEI o on configured 
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DISPLAY_ICA .SYSTEM .STATUS (DISISS) 
ANACD Subcommand 

Purpose This subcommand displays system configuration information. 

Format DISPLAY.ICA .SYSTEM .STATUS 

OUTPUT = fHe_name 
STATUS = status _variable _name 

Remarks This subcommand is an alias for the DISDSS subcommand. DISDSS is 
described in this chapter. 
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DISPLAY_LINE .CONTROL .BLOCK (DISLCB) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



Examples 



This subcommand displays the contents of selected fields of the configured 
line control block (CLCB) for a given line or all lines. 

DISPLAY_LINE .CONTROL _BLOCK 

LINE _NAME = line_name or keyword 

OUTPUT = file_name 

STATUS = status ^.variable _name 

LINE_NAME (LN) 

This parameter specifies the name of the line (up to 31 characters) for 
which CLCB information is desired. Line names are assigned in the 
Configuration File or with interactive NETOU commands (see the 
CDCNET Configuration Guide). The keyword ALL causes information to be 
displayed for all configured lines. 

If LINE_NAME is omitted, information is displayed for all configured 
lines. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. 

The following subcommand writes information about the line named 
LINE01 to output file OUTFILE. 



DISPLAY_LINE_C0NTR0L_8L0CK LINE_NAME=LINE01 OUTPUT=OUTFILE 



or 



DISLCB LN=LINE01 0=OUTFILE 
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Output from the DISPLAY_LINE .CONTROL _BLOCK subcommand is 
formatted as follows: 



FIGURED LINE CONTROL BLOCK 


AT ADDRESS 1423DC(16) 


POINTER TO FIRST TCCB 


0(16) 


POINTER TO ACTIVE LCB 


15AA20O6) 


POINTER TO NEXT CLCB 


140FF8O6) 


OPTIONAL TIP EXTENSION POINTER 


0(16) 


LINE NAME 


LINE01 


LINE INTERFACE MODULE 


1 


PORT NUMBER 


1 


TIP TYPE 


ASYNC TIP 


LINE TYPE 


DEDICATED 


FRAMING TYPE 


ASYNC 


CARRIER TYPE 


CONSTANT 


LINE SPEED 


1200 


ASYNC AUTOREC TYPE 


SPEED AND CODE SET 


CONNECT TIME TIMEOUT 





DISCONNECT TIMEOUT 


30 


USER CONNECTION LIMIT 


4 


EIA FLOW CONTROL 


TRUE 


EFC CLOCKING 


3 


LCSM TASK ID 


1421C8(16) 


TIP TASK ID 


0(16) 


CONFIGURATION CMD QUEUE 


0(16) 


ADD CB COUNT 





LCM STATE 


1 


LINE DOWN REASON 


VALUE = FF(16) 


AUTOREC TIP TYPE 


ASYNC TIP 


AUTOREC LINE SPEED 


AUTO 


AUTOREC CODE SET 


AUTO 


AUTOREC PARITY 


AUTO 


CONNECT TIMER 





LCSM LINE ENABLE STATUS 


TRUE 


LCSM STATE 


2 


LCSM AUTOREC STATE 


LINE NOT INITIALIZED 
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DISPLAY_LINKED_LIST (DISLL) 
ANACD Subcommand 

Purpose This subcommand displays a list of linked elements beginning at the 

specified machine address. Use DISPLAY_LINKED_LIST to track a chain 
of data structures in which the pointer to the next element in the chain 
resides at a known location within each data structure. 

Format DISPLAY.LINKED .LIST 

ADDRESS = address or entry point name 

LINKJOFFSET = integer 

BYTEjCOUNT = integer 

REPEAT JCOUNT = integer or ALL 

HEADER = integer 

OUTPUT = file_name 

STATUS = status _variable _name 

Parameters ADDRESS (A) 

This required parameter specifies the starting address of the linked list to 
be displayed. The value may be a memory address or an entry point name 
(externally defined variable) whose address is used as the base address for 
the display. Entry point names are found by using the DISPLAY. 
MEMORY_MAP subcommand described later in this chapter. 

LINKJOFFSET (LO) 

This parameter specifies the location within each linked list element of the 
pointer to the next element. LINK .OFFSET is expressed as the number of 
bytes from the beginning of each element in the linked list to the pointer 
to the next element. 

If LINK .OFFSET is omitted, the value is assumed. 
BYTEJCOUNT (BC) 

This parameter specifies the number of bytes to display for each element 
in the linked list. 

If BYTE .COUNT is omitted, the value 48 is assumed. 
REPEAT JCOUNT (RC) 

This parameter specifies the number of elements to display from the linked 
list. The keyword ALL causes all elements in the linked list to be 
displayed. 

If REPEAT.COUNT is omitted, all linked entries are displayed. 
HEADER (H) 

This parameter specifies the number of bytes to display as a header 
preceding the starting address of each linked list element. 

If HEADER is omitted, a value of is assumed (no header is displayed). 
OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 
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Examples 



STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

The following subcommand displays three elements of a linked list with 6 
bytes of header with each entry. The starting address of the list is 56E. 



DISPLAY_LINKED_LIST ADDRESS=56E REPEAT_C0UNT=3 HEADER=6 



Output from this subcommand is formatted as follows: 

DISPUY_UNKED_UST 

START ADDRESS: 56E 

HEX ADDR HEXADECIMAL DATA ASCII DATA 

568 1B3E 0016 5CFC » \ 

56E 0010 B950 0000 0042 0000 0000 0000 0000 P B 

57E 016C 2700 0000 0090 03E8 67FE 0000 2D82 1' g - 

58E 0010 6FD8 4717 0000 0000 0000 0594 016C o Q 

ADDRESS OF NEXT ELEMENT: 10B950 

HEX ADDR HEXADECIMAL DATA 

10B94A 80AE 0000 0000 

10B950 001 1 F1CC 0000 0042 0000 0000 434F 4E46 
10B960 4947 5552 4154 494F 4E5F 5354 4154 5553 
10B970 5F52 4550 4F52 5445 5220 2000 0003 0232 



ASCII DATA 



B C0NF 
IGURATION.STATUS 
REPORTER 2 



ADDRESS OF NEXT ELEMENT: 11F1CC 

HEX ADDR HEXADECIMAL DATA 

11F1C6 80AE 0000 0000 

11F1CC 0011 954C 0000 0016 0000 0000 4F4E 5F4C 
11F1DC 494E 455F 4C4F 4144 4552 2020 2020 2020 
11F1EC 2020 2020 2020 2020 2020 2000 0003 0232 



ASCII DATA 



L ON.L 
INE.LOADER 

2 



The same linked list without the header displayed would be shown in the 
following format: 



DISPLAY.LINKED.LIST 
START ADDRESS: 56E 



HEX ADDR 



HEXADECIMAL DATA 



56E 0010 B950 0000 0042 0000 0000 0000 0000 

57E 016C 2700 0000 0090 03E8 67FE 0000 2D82 

58E 0010 6FD8 4717 0000 0000 0000 0594 016C 

ADDRESS OF NEXT ELEMENT: 10B950 

HEX ADDR HEXADECIMAL DATA 

10B950 0011 F1CC 0000 0042 0000 0000 434F 4E46 

10B960 4S47 5552 4154 494F 4E5F 5354 4154 5553 

10B970 5F52 4550 4F52 5445 5220 2000 0003 0232 

ADDRESS OF NEXT ELEMENT: 11F1CC 

HEX ADDR HEXADECIMAL DATA 

11F1CC 0011 954C 0000 0016 0000 0000 4F4E 5F4C 

11F1DC 494E 455F 4C4F 4144 4552 2020 2020 2020 

11F1EC 2020 2020 2020 2020 2020 2000 0003 0232 



ASCII DATA 
P B 

y g 

O G 



ASCII DATA 

B CONF 
IGURATION.STATUS 
.REPORTER 2 



ASCII DATA 

L ON.L 

INEJ.OADER 

2 
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DISPLAY_LOG_QUEUES (DISLQ) 
ANACD Subcommand 



Purpose 



The DISPLAY_LOG_QUEUES subcommand displays information about 
available or specified log queues, including the log identifier and variable 
parts of the messages in the queues. For all types of queues, the messages 
are displayed in chronological order, 

NOTE 



The USE .TEMPLATES parameter, an optional parameter that formats the 
messages according to their templates, is a valid part of the command 
format but is not functional in this release. 



Format 



DISPLAY_LOG .QUEUES 

QUEUE JTYPE=keyword 
DISPLAY _OPTION= keyword 
USE ..TEMPLATES = boolean 
OUTPUT = file _name 
STATUS = status ..variable _name 



Parameters QUEUE JTYPE (QT) 



This parameter specifies the type of queue to display, from the following 
options: 

PRESERVE (P) 

The log message preserve queue saves the 15 most recent log messages 
that have been processed by the Log Support Application. These 
messages can be displayed from the dump file using this selection for 
the QT parameter. 

If a DI resets before initialization completes, the preserve queue may 
not yet be active. For the resulting dump file, this selection displays an 
informative message to that effect. 

INITIAL (INITIALIZATION or I) 

The log message initialization queue maintains log messages during the 
DI initialization process. If initialization fails to complete, these 
messages can be displayed from the dump file using this selection for 
the QT parameter. 

If a DI resets after initialization, the initialization queue is not active. 
For the resulting dump file, this selection displays an informative 
message to that effect. 

ITM 

This option is not functional in this release of CDCNET. 
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ALL 

All available log message queues are displayed. If both the preserve 
and initialization log queues were active when the DI reset, both 
queues are displayed with this option. 

If no queue type is specified, then all the active queues currently supported 
by this subcommand are displayed. 

DISPLAY JOPTION (DO) 

This parameter specifies the detail of data to be displayed for the selected 

queue type. If the keyword BRIEF (B, SUMMARY, or S) is specified, the 

date, time, system identifier and log identifier are displayed for each 

message. 

If the keyword FULL (F, EXPANDED, or E) is specified, all template 

identifiers and variable data for each log message are displayed. 

If DISPLAY_OPTION is not specified, a full display results. 

USE .TEMPLATES (UT) 

This parameter is not currently functional, but its position in the 
DISPLAY_LOG_QUEUES subcommand format is reserved. If you want to 
use the OUTPUT or STATUS parameters for this subcommand, either 
specify their names (for example, 0=QOUT), or skip over the UT 
parameter with a comma (for example, DISLQ,P,F„QOUT). 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 

output is written. This file may be any valid path name on NOS/VE. 

Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 

assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Remarks The date, time, log and template identifiers are displayed in decimal. The 
system address (system identifier) is displayed in hexadecimal. Variable 
data is displayed as it would be in the log file. 

See the CDCNET online Diagnostic Messages manual for descriptions of 
the log messages found in these queues. 
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Examples The following subcommand displays the initialization and preserve log 
queues, if active, in BRIEF format: 

DISLQ DO=B 
Output from this subcommand is formatted as follows: 
PRESERVE LOG QUEUE 

DATE TIME SYSTEM ID LOG ID 



87/11/12 


14 


.02.56.071 


080025100078 


618 


87/11/12 


14 


.07.50.409 


080025100078 


618 


87/11/12 


14 


.09.35.622 


080025100078 


618 


87/11/12 


14 


.13.43.929 


080025100078 


618 


87/11/12 


14 


.14.14.007 


080025100078 


620 


87/11/12 


14 


14.15.698 


080025100078 


618 


87/11/12 


14 


.16.48.683 


080025100078 


620 


87/11/12 


14, 


.17.53.305 


080025100076 


618 


87/11/12 


14 


20.17.082 


080025100078 


620 


87/11/12 


14. 


20.22.493 


080025100078 


618 


87/11/12 


14. 


23.54.781 


080025100078 


620 


87/11/12 


14. 


.28.38.571 


080025100078 


619 


87/11/12 


14. 


28.52.266 


080025100078 


617 


87/11/12 


14. 


28.56.149 


080025100078 


617 


87/11/12 


14. 


31.03.281 


080025100078 


620 
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The following subcommand displays the preserve log queue in FULL 
format: 

DISLQ QT-P D0=F 

Output from this subcommand is formatted as follows: 

PRESERVE LOG QUEUE 

DATE TIME SYSTEM ID LOG ID 



87/11/12 14.02.56.071 080025100078 618 
Template ID ■ 155 
Variable data fields: 



1 


VE102 


2 


4 


3 


3 


4 


L07843 


5 


38400 


6 


DED 


7 




8 


$CONSOLE_100078_4300000000 


9 





10 





11 


CON 


12 


ASYNCTIP 


13 


ASYNC 


14 


0000A002080025 1 00078AB 1 B 


15 


00990 102080025D00066509 1 



87/11/12 14.07.50.409 080025100078 618 
Template ID - 155 
Variable data fields: 



1 


S01 


2 


5 


3 


2 


4 


L07852 


5 


19200 


6 


SW 


7 




8 


$CONSOLE_100078_5200000000 


9 





10 





11 


CON 


12 


ASYNCTIP 


13 


ASYNC 


14 


OOOOA0020800251 00078AB 1B 


15 


000000630800253000D1FEBF 



60000414 C DI Dump Analyzer Commands 19-45 



DISPLAY_MEMOBY (DISM) 



DISPLAYJMEMORY (DISM) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



The DISPLAY_MEMORY subcommand displays memory contents beginning 
at the specified machine address or externally defined entry point. Display 
is in both hexadecimal and ASCII formats. 

DISPLAY_MEMORY 

ADDRESS = address or entry point name 

BYTEJOFFSET = integer 

BYTEjCOUNT = integer 

REPEAT JCOUNT = integer or keyword 

OUTPUT = file_name 

STATUS = status _variable _name 

ADDRESS (A) 

This required parameter specifies the base address used for memory 
display. It may be specified as either a numeric machine address or an 
externally defined entry point name. Entry point names are found by using 
the DISPLAY_MEMORY_MAP subcommand, described in this chapter. 

BYTEJOFFSET (BO) 

This parameter specifies the offset to the base address established by the 
address parameter. Its value is added to the base address to form a new 
address. 

If BYTE .OFFSET is omitted, display begins from the base address. 
BYTEjCOUNT (BC) 

This parameter specifies the number of bytes to be displayed, 16 bytes to a 
line. Or, in conjunction with the REPEAT_COUNT parameter, it specifies 
the length in bytes of each item to be displayed. Using BYTE_COUNT 
and REPEAT_COUNT together lets you display memory in groups of 
bytes, such as when a data structure of known length is repeated through 
memory. 

If BYTE_COUNT is omitted, a value of 1 is assumed. 
REPEAT JCOUNT (RC) 

This parameter specifies the number of items of length BYTE _COUNT to 
be displayed. The keyword ALL causes all memory from the specified 
address to the end of memory to be displayed. If no byte count is specified, 
REPEAT_COUNT specifies the number of bytes to be displayed, 16 bytes 
to a line. 

If REPEAT_COUNT is omitted, only one item of length BYTE_COUNT is 
displayed. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 
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STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Remarks The REPEAT_COUNT parameter produces the most readable display if 
only one form of count is required, since an address is shown for every 
line of output. 

If both the REPEAT_COUNT and BYTE_COUNT parameters are omitted, 
then 128 bytes (eight lines of 16 bytes each) are displayed rather than just 
one byte. (See the examples.) 

Examples The following subcommand displays 48 one-byte long items, starting at 
hexadecimal address 8400. 

DISPLAY.MEMORY ADDRESS=8400 RC=48 

Output from this subcommand is formatted as follows: 

START INS ADDRESS: OOD08400 

HEX ADDR HEXADECIMAL DATA ASCII DATA 

00008400 0007 0007 005A 0002 0000 0042 0000 0020 Z B 

00008410 0000 0800 0013 B116 0000 0000 FF00 0000 

00008420 0040 0000 0042 0000 001A 0010 0000 7FFF B 



The following subcommand displays five items, where each item is 20 bytes 
long, starting at decimal address 100. 

DISM A=100(10) BC=20(10) RC=5 

Output from this subcommand is formatted as follows: 



STARTING ADDRESS: 00000064 

HEX ADDR HEXADECIMAL DATA 

00000064 0000 0000 0000 0000 0000 0000 0000 0000 

oooo 0000 

00000078 0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 
0000008C 0000 0000 0000 0000 0000 0000 0000 0000 

OOOO 0000 
0OO0OOA0 0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 
0O00OOB4 0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 



ASCII DATA 



The following examples show three ways to display 72(16) bytes of data, 
starting at memory address 400(16). 

DISM 400(16) BC=72(10) 

Output from this subcommand is formatted as follows: 

DISPLAY.MEM0RY a*400(16> bC"72(10> 
STARTING ADDRESS: 400 

HEX ADDR HEXADECIMAL DATA 



400 0800 2510 0081 6AA1 0000 5CO0 0020 0000 
0000 052C 0001 002C 8032 3204 1613 2921 
0000 0000 0000 0000 0000 0000 0600 B542 
0000 0000 0000 0000 0100 0000 0000 0000 
0000 0000 0000 0000 



ASCII DATA 

x i \ 

, , 22 ) 
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The following example uses both the BYTE COUNT and REPEAT 
COUNT parameters. ~ 

DISM 400 BC=6 RC=12 

Output from this subcommand is formatted as follows: 

START INS ADDRESS: 400 

HEX ADDR HEXADECIMAL DATA ASCII DATA 

400 0800 2510 0081 % 

406 6AA1 0000 5CO0 j \ 

40C 0020 0000 0000 

412 052C 0001 002C 

418 8032 3204 1613 22 ' 

41E 2921 0000 0000 ) 

424 0000 0000 0000 

42A 0000 0600 B542 B 

430 0000 0000 0000 

436 0000 0100 0000 

43C 0000 0000 0000 

442 0000 0000 0000 

The following example uses only the REPEAT_COUNT parameter. 

DISM 400(16) RC=72(10) 

Output from this subcommand is formatted as follows: 

DISPLAY.MEMORY a=400O6) rc=72(10) 
STARTINS ADDRESS: 400 
HEX ADDR HEXADECIMAL DATA ASCII DATA 



\ 



400 0800 2510 0081 6AA1 0000 5C00 0020 0000 X j , 

410 0000 052C 0001 O02C 8032 3204 1613 2921 , , 22 ) 

420 0000 0000 0000 0000 0000 0000 0600 B542 ' ' B 

430 0000 0000 0000 0000 0100 0000 0000 0000 

440 0000 0000 0000 0000 

The following subcommand uses neither the REPEAT_COUNT nor the 
BYTE .COUNT parameters: 

DISM 400 
Output from this subcommand is formatted as follows: 

STARTING ADDRESS: 400 

HEX ADDR HEXADECIMAL DATA ASCII DATA 

400 0800 2510 0081 6AA1 0000 5C00 0020 0000 X j \ 

410 0000 052C 0001 002C 8032 3204 1613 2921 , . 22 ) 

420 0000 0000 0000 0000 0000 0000 0600 B542 ' B 

430 0000 0000 0000 0000 0100 0000 0000 0000 

440 0000 0000 0000 0000 0000 0000 0000 0000 

450 0000 0000 0000 0000 0000 0000 0000 0000 

460 0000 0000 0000 0000 0000 0000 0000 0000 

470 0000 0000 0000 0000 0000 0000 0000 0000 



19-48 CDCNET Commands 



60000414 C 



DISPLAY_MEMORY_JIEADER (DISMH) 



DISPLAY JMEMORY_HEADER (DISMH) 
ANACD Subcommand 

Purpose This subcommand displays information from the allocation header of a DI 
memory extent. Included in the display are the type of extent, the extent 
size, and the owner identifier. 

Format DISPLAY_MEMORY_HEADER 

ADDRESS = address 
BEGINNING JOFJSXTENT = keyword 
OUTPUT = file_name 
STATUS = status _variable _name 

Parameters ADDRESS (A) 

This required parameter specifies an address from a DI memory extent. 
The allocation header of the extent is displayed. This address need not 
specify the beginning of the memory extent (see the BEGINNING _OF_ 
EXTENT parameter, described next). 

BEGINNING _OF_EXTENT (BOE) 

If the ADDRESS you specify is the beginning of a memory extent and this 
parameter is set to TRUE (ON or YES), response-time for this 
subcommand is improved by eliminating a search for the beginning of 
extent. 

If this parameter is not specified, or if it is set to FALSE (OFF or NO), 
then the subcommand processor searches for the allocation header that 
describes the memory extent containing the address specified by the 
ADDRESS parameter. 

NOTE 

The beginning of extent is the start of the usable area in the memory 
extent. Be careful if you specify BOE = YES that the address you specify is 
actually the start of the usable area and not the start of the allocation 
header that is located six bytes before it. If you are uncertain, leave off 
the BOE parameter and let the subcommand processor make the search. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples 



The following subcommand displays information from the memory extent 
that starts at address 102DAE(16): 

DISPLAY_MEMORY_HEADER ADDRESS=102DAE BEGINNING_OF_EXTENT=YES 
Output from this subcommand is formatted as follows: 
MEMORY HEADER DISPLAY 



For address: 102DAE(16), Beginning of extent: 

= yes 



102DAEO6) 



Al located 
Owner Identifier 
Byte size 
Task identifier 
Description 
Type 



F01K16) 
32 
104970(16) 
ON_LINE_LOADER 
descriptor buffer 



The following subcommand displays information from the header of the 
memory extent that contains address 102DB4(16): 

DISMH A=102DB4 
Output from this subcommand is formatted as follows: 
MEMORY HEADER DISPLAY 



For address: 102DB4(16), Beginning of extent: 102DAE(16) 



Al located 
Owner identifier 
Byte size 
Task identifier 
Description 
Type 



yes 

F01K16) 
32 
104970(16) 
ON_LINE_LOADER 
descriptor buffer 
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DISPLAYJMEMORY JMAP (DISMM) 
ANACD Subcommand 

Purpose This subcommand displays the names and locations of the software modules 

that were in the DI when it was reset, including deloadable modules. For 
each module, the symbolic name of the module and the date and time the 
module was created (compiled or assembled), are always displayed. Use the 
DISPLAY_OPTION parameter to select additional information for display. 

Format DISPLAY_MEMORY_MAP 

MODULE = module name or keyword 
DISPLAY JOPTION = keyword 
OUTPUT = file_name 
STATUS = status _variable _name 

Parameters MODULE (M) 

This parameter specifies the name of a particular module for which 
information is to be displayed. If the keyword ALL is specified, information 
is displayed for all modules. 

If MODULE is omitted, information is displayed for all modules. 

DISPLAY JOPTION (DO) 

This parameter specifies the type of information to be included in the 
memory map. The options are: 

DO = ENTRY (E) 

Selects display of the following entry-point information: 

• Symbolic name of entry-point 

• Hexadecimal address of entry-point 

• Relative address (offset) of entry-point 

DO = SECTION (S) 

Selects display of the following section information: 

• Section ordinal 

• Hexadecimal address of section 

• Section length 

• Section type 

DO = FULL (F) 

Selects display of both entry-point and section information (options E 
and S). 

If DISPLAY_OPTION is omitted, DO=E is assumed. 
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Remarks 



Examples 



OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Modules on the deloadable module list are displayed by the DISPLAY. 
MEMORY_MAP subcommand. In the display, the deloadable module list 
appears after the loaded module list. 

The following subcommand displays module section information for the 
dump file being analyzed: 

DISPLAY_MEMORY_MAP DISPLAY_OPTI0N=SECTION 



or 



DISMM DO=S 
Output from this subcommand is formatted as follows: 



LOADED MODULE LIST 

MODULE NAME / SECTION ORDINAL 



HEX HEX 

ADDRESS LENGTH SECTION KIND 



EXEC.MPB 

SECTION 0( 16) 
SECTION 1(16) 


February 27, 1985 11:36 PM 
1340 1CBC CODE.SECTION 
3002 1FE WORK ING.STORAGE.SECT ION 


DELOADABLE MODULE LIST 
MODULE NAME / SECTION ORDINAL 


HEX HEX 

ADDRESS LENGTH SECTION KIND 


DISPLAY_D1_SYSTEM STATUS 
SECTION 0(16) 
SECTION 1(16) 
SECTION 2( 16) 
SECTION 3( 16) 
SECTION 4( 16) 
SECTION 5(16) 


1985/02/27 17:45:42 
199632 8E2 CODE.SECTION 
107D64 46 WORKING.STORAGE.SECTION 
190908 10 W0RKING.ST0RA6E.SECTION 
19092E 18 WORK ING.STORAGE.SECT ION 
195A86 28 WORK ING.ST0RA6E.SECT ION 
195D58 CB W0RKING_STORAGE.SECTI0N 
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If you omit the DISPLAY_OPTION parameter (or select DO=E), the 
DISPLAY_MEMORY_MAP subcommand generates a display in the 
following format: 



LOADED MODULE LIST 
MODULE/ENTRY.POINT NAME 



HEX 

ADDRESS 



HEX 
OFFSET 



TRMSCP 1985/02/27 22:54:51 

CMD_DISPLAY_TRANSPORT_STATUS 116394 SEC 0(16) +68A(16) 
CMD.DISTS 116D32 SEC 0(16) +1028(16) 



DELOADABLE MODULE LIST 
MODULE/ENTRY.POINT NAME 



HEX 
ADDRESS 



HEX 
OFFSET 



DISPLAY_DI_SYSTEM_STATUS 1985/02/27 17:45:42 

CMD_DISPLAY_DI_SYSTEM_STATUS_TA 19090C SEC 2(16) +4(16) 

CMD_DISDSS_TA 190912 SEC 2(16) +A(16) 

CMD_DISPLAY_DI_SYSTEM_STATUS 199632 SEC 0(16) +0(16) 

CMD_DISDSS 1997BE SEC 0(16) +18C(16) 



If you specify DO=F, you get both entry-point and section information. 
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DISPLAY_MEMORY_USERS (DISMU) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



This subcommand provides a means of determining the memory usage 
within the DI as a whole, or by a specific task, owner identifier, or owner 
description. 

An optional parameter, ANACD .DIRECTIVES, gives you the choice of 
building a Dump Analyzer input file to help you with further dump 
analysis. When the input file is processed, the contents of owned memory 
extents are displayed. 

DISPLAY_MEMORY_USERS 

MEMORY _USER = address, task_name, owner description or ALL 

EXTENT JTYPE = keyword 

DISPLAYJOPTION = keyword 

OUTPUT = file_name 

ANACD _DIRECTIVES = file_name 

STATUS = status _variable _name 

MEMORYJUSER (MU) 

This parameter specifies the identity of the user whose memory 
characteristics are displayed. 

• If an integer in the range 1..0ffff(16) is specified, it is assumed to be 
an owner _id. Larger integers are interpreted as Task Control Block 
(TCB) addresses. 

• If a name is specified, then it is assumed to be a task name. Data for 
all owner _ids for TCBs scheduled for the specified task are displayed. 

• If the value is a string, it is assumed to be an owner .description and 
the list of owner descriptions is scanned to get the owner _id. 

• If ALL is specified, the memory characteristics of all users are 
displayed. 

If no value is specified, then ALL is assumed. 



kSZJFmSL %r#wu at |?TT S ? eC i^ Uy «* te«kli* memory ownership, and are associated with each Task 
Control Block (TCB); the FULL display option of the DISPLAY.TASK.CONTROLJLOCK subcommand 
displays the owner _jd for each TCB displayed. ™wmu«muu 
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EXTENT JTYPE (ET) 

This parameter specifies the type of memory extent whose user(s) is 
displayed. Keywords are: 

MEMORY (M) 

Ownership of allocatable memory extents is displayed. 

BUFFER (B) 

Ownership of buffers is displayed. 

ALL 

Ownership of both allocatable memory extents and buffers is displayed. 
If this parameter is omitted, then ALL is assumed. 

DISPLAY JOPTION (DO) 

This parameter specifies the amount of data to be displayed. If FULL (or 
EXPANDED) is specified, information about all types of memory owned by 
the specified user or all users is displayed. If BRIEF (or SUMMARY) is 
specified, one line of summary information about buffer usage and one line 
about memory usage is displayed per user. 

If the DO parameter is not specified, then BRIEF is assumed. 

OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

ANACD JXRECTWES (AD) 

This parameter specifies the file to be used later as a Dump Analyzer 
input file to display the memory extents specified by the MU and ET 
parameters. When you use this parameter, the Dump Analyzer locates 
memory extents in accordance with the MU and ET parameters, and then 
generates directives to display the contents of these memory extents. The 
file named on this parameter can be edited before it is submitted to the 
Dump Analyzer as an input file. (See Remarks for further explanation.) 

This parameter is only functional when the DISPLAY_OPTION is specified 
as FULL. If you attempt to use the AD parameter in conjunction with 
DO = BRIEF, a warning message is issued and the AD parameter is 
ignored. 

If the ANACD .DIRECTIVES parameter is not specified, no directives file 
is produced. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Remarks 



Examples 



If you want a full display of all memory users, this subcommand takes 
some time to process since the entire dump is searched for the memory 
that belongs to each owner. The display of memory use for each memory 
owner is output as it is determined, with pauses before each new owner. 
To warn interactive users, a message is output at the start of the 
subcommand. It reads as follows: 

—WARNING DA 124— This command may take some time. There are 
[text] owner_1ds for which memory use is displayed. 

If you use the ANACD_DIRECTIVES parameter, take note of the 
following: 

• DISPLAY_BUFFER_CHAIN directives are generated for extents that 
are determined to be heads of buffer chains. Other buffer types do not 
generate directives, as they should be included when the whole buffer 
chain is displayed. The DISBC directives specify DO=F and an output 
file name of ZZZDABO. The owner identifier and description are 
appended as comments in the directives file. 

• DISPLAY_MEMORY directives are generated for all memory extents, 
using the extent size as the RC parameter and an output file name of 
ZZZDAMO. The owner identifier and extent type are appended as 
comments in the directives file. 

• Directives files are suitable for reprocessing by the Dump Analyzer 
without modification. To submit the directives: 

- Under NOS/VE, use INCLUDE _FILE. 

- Under NOS, start a separate Dump Analyzer session and specify the 
directives file for the I parameter. 

If you want to edit a directives file to remove unwanted subcommands 
or to change parameter specifications before submitting the file for 
processing, use a NOS or NOS/VE file editor. Under NOS/VE, you can 
use EDIT_FILE to edit the directives file without leaving the current 
Dump Analyzer session. Under NOS, you must end your current Dump 
Analyzer session before using a file editor. 

The following subcommand displays information, in the BRIEF format, 
about System Ancestor memory usage: 

DISPLAY_MEMORY_USERS MEMORY_USER=SYSTEM_ANCESTOR DISPLAY OPTION=BRI- 
EF 

Output from this subcommand is formatted as follows: 

DISPLAY MEMORY USERS 

MEMORY USAGE 
owner description # of extents total bytes TCB address 



F000 SYSTEM.ANCESTOR 
BUFFER USAGE 
owner description 



111 



126814 104120 



# of buffers total bytes TCB address 



F000 SYSTEM.ANCESTOR 



64 



104120 
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NOTE 



If you select the BRIEF display for all memory users, you might see some 
memory owners described as *** UNKNOWN ***. This occurs when a task 
terminates without freeing its memory extents, since the owner _id does 
not correspond with any of the owner _ids found on the active TCB chain. 

This situation is not necessarily a problem, as some tasks pass a memory 
extent pointer to a secondary user before terminating. Loss of memory 
should be suspected, however, when the concurrent memory state is found 
to be congested. 



The following subcommand displays full memory-use information for all 
memory users: 

DISMU MU=ALL DO=F 

Output from this subcommand is formatted as follows: 

DISPLAY MEMORY USERS 

Owner Identifier = 1(16) INTERRUPT LEVEL REQUEST 

TCB Address « N/A 

address bytes type 



105EDO 


70 


intertask 


message 


from global 


memory 


Owner Identifier 
TCB Address 


s 


21(16) 
N/A 


MEMBER OF LOG MSG QUEUE 


address 


bytes 


type 









1023E2 32 head of buffer chain (descriptor) 

107DD6 32 descriptor buffer from global memory 

127270 146 data buffer 

1273EC 32 descriptor buffer 

If you specify the ANACD ..DIRECTIVES parameter on this subcommand, 
an input directives file is created for use with the ANACD command. The 
file contains DISPLAY_MEMORY and DISPLAY_BUFFER .CHAIN 
subcommands, and notes the associated memory owner. It is formatted as 
follows: 

DISM A=0105EDO RO0070O0) OZZZDAMO.$E01 "OWNER: 1 TYPE: 1TM/GUBAL MEM" 

DISBC A«01023E2 D0=F 0=ZZZDAB0.$E01 "OWNER: 21/ MEMBER OF LOG MSG QUEUE" 



D1SM A=0010006 RC=0032(10) 0=ZZ2DAM0.$E01 "OWNER 

DISM A-001002C RC«5 162(10) 0*ZZZDAM0.$E0I "OWNER 

DISM A-0011F0C RC*O906(10) 0=ZZZDAM0.$E01 "OWNER 

DISM A«00158CA RC*0108(10) O-ZZZDAMO. $E0I "OWNER 

DISM A=0015AB8 RC-0032(10) 0*ZZZDAM0.SE01 "OWNER 

OISM A»0016Z2« RO0298O0) 0*Z2ZDAM0.$E0I "OWNER 

DISM A*00170FC RC«1780(10) O'ZZZDAMO.SEOI "OWNER 



50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 
50 TYPE: USER MEMORY" 



The output file named on these directives is ZZZDAMO. Note that 
directives generated under the NOS operating system do not specify the 
$EOI file position, since file position is not a component of NOS file 
names. 
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DISPLAY_NETWORK_STATUS (DISNS) 
ANACD Subcommand 

Purpose This subcommand displays status information concerning all networks 
connected to this DI when the DI was reset. 

Format DISPLAY_NETWORK STATUS 

OUTPUT = file_name 

STATUS = status _variable _name 

Parameters OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Examples The following subcommand displays the network status of the DI at the 
time of reset: 

DISPLAY_NETWORK_STATUS 

Output from this subcommand is formatted as follows: 

DISPLAY NETWORK STATUS 

network_name - $NET_1 

network_type = Ethernet 

network_1dent1fier ■ 000000001(16) 
network_status = active 

network_cost = 000OA (16) 

network_name * $NET_2 

network_type - X.25 

network, Identifier = 00000064(16) 
network_status = active 

network_cost « 06FA (16) 

If no networks were connected to the DI when the dump file was written, 
then the following message is displayed: 

No networks defined. 
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Remarks The following values may be seen in the DISPLAY_NETWORK_STATUS 
display: 

network _type Ethernet, HDLC, X.25, for example 

network _status Active, enabled, congested, configured 

NOTE 

The value displayed for network _cost is the configured cost of the network, 
not the dynamically assigned adjusted _cost. 
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DISPLAY_SYSTEM .CONFIG _TABLE (DISSCT) 
ANACD Subcommand 

Purpose This subcommand displays information from the system configuration table. 

Format DISPLAY_SYSTEM CONFIG TABLE 

OUTPUT = file -name 

STATUS = status _variable _name 

Parameters OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. If OUTPUT is omitted, the output file name 
on the ANACD command is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Remarks In the displays that follow, QNEXT is now described as "ADDRESS OP 
FIRST ENTRY IN QUEUE." In previous releases, this read, "ADDRESS 
OF NEXT ENTRY IN QUEUE." 

Examples The following subcommand writes system configuration table information to 
the file OUTFILE. 

DISPLAY_SYSTEM_CONFIG_TABLE OUTPUT =OUtf 1 le 

Output from this subcommand is formatted as follows: 

SYSTEM CONFIGURATION TABLE DISPLAY 



DATA BUFFER AVAILABLE COUNT 


2868 


DESCRIPTOR BUFFER AVAILABLE COUNT 


1006 


DATA SPACE LENGTH <BYTES) 


144 


DESCRIPTOR BUFFER LENGTH (BYTES) 


32 


STANDARD STACK ALLOCATION (BYTES) 


2048 


RUNNING TASK POINTER 


1883D8(16) 


FREE GLOBAL MEMORY (BYTES) 


4660 


FREE PRIVATE MEMORY (BYTES) 


16150 


FREE MPB RAM MEMORY (BYTES) 


2336 


FREE GLOBAL MEMORY EXTENTS (BYTES) 


100 


FREE PRIVATE MEMORY EXTENTS (BYTES) 


11 


FREE MPB RAM MEMORY EXTENTS (BYTES) 


1 


DELOADABLE MPB RAM (BYTES) 





DELOADABLE PMM (BYTES) 





DELOADABLE SMM (BYTES) 


201506 


DELOAD THRESHOLD - MPB RAM (BYTES) 





DELOAD THRESHOLD - PMM (BYTES) 


4000 


DELOAD THRESHOLD - SMM (BYTES) 


30000 


BINARY TIME OF DAY 


1752400 


BCD DATE AND TIME 86/02/01 


23.20.34.070 


ASSUMED YEAR 


86 


INTERRUPT FIREWALL CHAIN ADDRESS 


0(16) 


NUMBER OF DATA BUFFERS 


3247 


NUMBER OF DESCRIPTOR BUFFERS 


1082 


STACK OVERFLOW AREA ALLOCATION (BYTES) 


240 


OVERFLOWING TASK POINTER 


0(16) 


PC CHK INSTRUCTION EXECUTION ADDRESS 


0(16) 


USP CHK INSTRUCTION EXECUTION ADDRESS 


0(16) 


LARGEST ADDRESS IN RESERVED MEMORY 


18E70(16) 


RESERVE RAM MEMORY (BYTES) 





RESERVE GLOBAL MEMORY EXTENTS 





MEMORY STATE 


memory.good 


BUFFER STATE 


buffer .good 
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SYSTEM CONFIGURATION TABLE DISPLAY (Continued) 

MPB TYPE MPB 

PMM ALLOCATED ANY (BYTES) 

AVAILABLE TO ANY (BYTES) 63536 

CURRENT PMM REQUIRED (BYTES) 



MAXIMUM PMM REQUIRED (BYTES) 63536 

DELOAD PMM ANY (BYTES) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY » 

LENSTH { LENSTH OF QUEUE ) 0(16) 

COUNT { NUMBER OF ENQUEUES ) 13A( 16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 0(16) 

QLAST ( ADDRESS OF LAST ENTRY IN QUEUE ) 0( 16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE ) 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 1 

LENSTH { LENSTH OF QUEUE ) 0(16) 

COUNT { NUMBER OF ENQUEUES } 0(16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 0(16) 

QLAST ( ADDRESS OF LAST ENTRY IN QUEUE ) 0( 16) 

QCHARACTERS < NUMBER OF CHARACTERS IN QUEUE ) 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 2 

LENSTH { LENSTH OF QUEUE ) 0(16) 

COUNT { NUMBER OF ENQUEUES ) 0( 16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE } 6) 

QLAST < ADDRESS OF LAST ENTRY IN QUEUE } 0( 16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 3 

LENSTH ( LENGTH OF QUEUE ) 0( 16) 

COUNT { NUMBER OF ENQUEUES ) 2676(16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE } 0(16) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE ) 0(16) 

QCHARACTERS ( NUMBER OF CHARACTERS IN QUEUE } 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 4 

LENGTH { LENGTH OF QUEUE ) 0( 16) 

COUNT { NUMBER OF ENQUEUES ) 0(16) 

QNEXT ( ADDRESS OF FIRST ENTRY IN QUEUE ) 0(16) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE > 0(16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 0(16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 5 

LENGTH { LENSTH OF QUEUE ) 1(16) 

COUNT { NUMBER OF ENQUEUES ) 59D6( 16) 
QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) Z361 1A( 16) 
QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 2361 1A( 16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY = 6 

LENGTH { LENGTH OF QUEUE ) 0(16) 

COUNT { NUMBER OF ENQUEUES ) 0(16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 0(16) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE ) 0(16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 0( 16) 

SCHEDULED TASKS PRIORITY READY LISTS PRIORITY • 7 

LENSTH { LENSTH OF QUEUE } 0(16) 

COUNT { NUMBER OF ENQUEUES ) 0( 16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 0(16) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE ) 0( 16) 

QCHARACTERS < NUMBER OF CHARACTERS IN QUEUE } 0( 16) 

GLOBAL MEMORY EXTENT LIST 

LENGTH { LENSTH OF QUEUE } 64(16) 

COUNT { NUMBER OF ENQUEUES } E36A(16) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 116C4606) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 27FE32{16) 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE ) 0( 16) 
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SYSTEM CONFIGURATION TABLE DISPLAY (Continued) 

PRIVATE MEMORY EXTENT LIST 

LENGTH { LENGTH OF QUEUE } 

COUNT { NUMBER OF ENQUEUES } 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE ) 

MPB RAM MEMORY EXTENT LIST 

LENGTH < LENGTH OF QUEUE } 

COUNT { NUMBER OF ENQUEUES } 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 

DEFINED INTERRUPTS LIST 

LENGTH { LENGTH OF QUEUE } 

COUNT { NUMBER OF ENQUEUES J 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 

DATA BUFFER QUEUE 

LENGTH { LENGTH OF QUEUE } 

COUNT { NUMBER OF ENQUEUES } 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE } 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 

DESCRIPTOR BUFFER QUEUE 

LENGTH { LENGTH OF QUEUE ) 

COUNT { NUMBER OF ENQUEUES ) 

QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 

QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 

QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE } 

RESERVE RAM MEMORY EXTENT LIST 
LENGTH { LENGTH OF QUEUE ) 
COUNT { NUMBER OF ENQUEUES } 
QNEXT { ADDRESS OF FIRST ENTRY IN QUEUE ) 
QLAST { ADDRESS OF LAST ENTRY IN QUEUE } 
QCHARACTERS { NUMBER OF CHARACTERS IN QUEUE ) 



B(16) 

130EO6) 

10C7A 6) 

2B762( 16) 

0(16) 



1(16) 

U16) 

592(16) 

592(16) 

0(16) 



11(16) 

11(16) 

189900(16) 

189002(16) 

0(16) 



B34(16) 

B53F06) 

19EC1A(16) 

2427B6( 16) 

0(16) 



3EE(16) 

36DE06) 

2571BA06) 

Z571B0O6) 

0(16) 



0(16) 
0(16) 
0(16) 
0(16) 
0(16) 



If a value in the above display is too large to be displayed, a 
string of asterisks Is Inserted into the value portion of the 
display to indicate this condition. 
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DISPLAY_TASK .CONTROL _BLOCK (DISTCB) 
ANACD Subcommand 

Purpose This subcommand displays the contents of selected fields for one or more 
active Task Control Blocks (TCBs) in the dump file. 

Format DISPLAYJTASK .CONTROL .BLOCK 

TASK JDENTIFIER = address, task name, or keyword 

DISPLAY jOPTION = keyword 

OUTPUT = file_name 

STATUS = status _variable _name 

Parameters TASK JDENTIFIER (TI) 

This parameter specifies the TCBs to be examined. If TASK ..IDENTIFIER 
is an address, information from the TCB at that address is displayed. If 
TASK_IDENTIFIER is a task name, all TCBs with that task name are 
displayed. The keyword ALL causes all tasks to be processed, beginning 
with the system ancestor task. 

If TASK_IDENTIFIER is omitted, only the currently selected task is 
processed. The currently selected task is the task specified by the 
SELECT_TASK subcommand (described in this chapter). If SELECTJTASK 
has not been used to specify a task, the task running when the DI was 
reset is assumed. If no task was running when the DI was reset, the 
Dump Analyzer issues diagnostic message number 37. 

DISPLAY JOPTION (DO) 

This parameter specifies the amount of data to be displayed. If BRIEF (or 
SUMMARY) is specified, summary information is displayed for each TCB. 
If FULL (or EXPANDED) is specified, a more extensive display is 
generated for each TCB. 

If DISPLAY_OPTION is not specified, BRIEF is assumed. 

OUTPUT (0) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is not specified, the output file name on the ANACD command 
is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples The following subcommand displays expanded information from all of the 
TCBs with task name XEROX _INTERNET_ROUTINES. 

D]SPLAY_TASK_CONTROL_BL0CK TASK_IDENT1FIER=XER0X_INTERNET_R0UTINES DlSPLAY_0PTI0N=FULL 

Output from this subcommand is formatted as follows: 

TASK CONTROL BLOCK DISPLAY 



TCB ADDRESS 1C4C02O6) 
TASK NAME XEROX.INTERNET.ROUT1NES 

NEXT.TASK { CHAIN TO NEXT TASK POINTER ) 0( 16) 

ID { TCB IDENTIFICATION } ITCB 

STSIZ { SIZE OF CURRENT STACK SEGMENT ) 8F0O6) 

CHLDQ { TASK POINTER OF NEXT SIBLING } 1C4B1E06) 

ADULT { TASK POINTER OF PARENT ) 103B5BO6) 

CHILD < TASK POINTER OF CHILD ) 0(16) 

STACK { ADDRESS OF CURRENT STACK SEGMENT } 1CEB94( 16) 

STATE { CURRENT STATE > WAIT 

PRIORITY { ACTUAL PRIORITY } i 

EXPRESS ITM { NUMBER EXPRESS INTER.TASK MSGS QUEUED ) 0(10) 

NORMAL ITM { NUMBER NORMAL INTER.TASK MSGS QUEUED ) 0(10) 

SR ( STATUS REGISTER ) 



PC 
A6 
A7 



TRACE MODE 
M68000 MODE 
INTERRUPT MASK 
RESULT EXTENDED 
RESULT NEGATIVE 
RESULT ZERO 
OVERFLOW 
CARRY 
{ PROGRAM COUNTER ) 
{ STACK POINTER ) 
( STACK POINTER ) 
MODULE NAME 



NO 

USER 

OOO 

NO 

NO 

NO 

NO 

NO 



EXEC.PMM 



10A774( 16) 
1CF4 10(16) 
1CF4 10(16) 



OWNER. ID 



OFFSET IN CODE SECTION 142(16) 
{ ID GENERATED FOR MEMORY OWNERSHIP ) 



F01F(16) 



TASK CONTROL BLOCK DISPLAY 



TCB ADDRESS 1C4B1E(16) 

TASK NAME XEROX. INTERNET.ROUTINES 

NEXT.TASK { CHAIN TO NEXT TASK POINTER ) 0(16) 

ID { TCB IDENTIFICATION ) ITCB 

STSIZ { SIZE OF CURRENT STACK SEGMENT } 8F0< 16) 

CHLDQ ( TASK POINTER OF NEXT SIBLING ) 1C4A3A( 16) 
ADULT { TASK POINTER OF PARENT } 103B56O6) 

CHILD { TASK POINTER OF CHILD ) 0( 16) 

STACK { ADDRESS OF CURRENT STACK SEGMENT ) 1CE286I 16) 
STATE { CURRENT STATE ) WAIT FOR ANY MESSAGE 

PRIORITY { ACTUAL PRIORITY ) 1 

EXPRESS ITM { NUMBER EXPRESS INTER.TASK MSGS QUEUED ) 0(10) 
NORMAL ITM { NUMBER NORMAL INTER.TASK MSGS QUEUED } 0( 10) 
SR { STATUS REGISTER ) 

TRACE MODE NO 

M38000 MODE USER 

INTERRUPT MASK 000 

RESULT EXTENDED NO 

RESULT NEGATIVE NO 

RESULT ZERO NO 

OVERFLOW NO 

CARRY NO 

{ PROGRAM COUNTER } 
{ STACK POINTER ) 
{ STACK POINTER ) 

MODULE NAME EXEC PMM 

OFFSET IN CODE SECTION 142(16) 
{ ID GENERATED FOR MEMORY OWNERSHIP ) 



PC 
A6 
A7 



OWNER. ID 



10A774O6) 
1CEB2E( 16) 
1CEB2E( 16) 



F01EO6) 



19-64 CDCNET Commands 



60000414 C 



DISPLAYJIASK_CONTROL_PLOCK (DISTCB) 



TASK CONTROL BLOCK DISPLAY 



TCB ADDRESS 






1C4A3A06) 


TASK NAME 


XEROX.INTERNET.ROUTINES 






NEXT.TASK 


{ CHAIN TO NEXT TASK POINTER } 


0(16) 


ID 


{ TCB IDENTIFICATION } 




1TCB 


STStZ 


< SIZE OF CURRENT STACK SEGMENT ) 


8F0O6) 


CHLDQ 


{ TASK POINTER OF NEXT SIBLING ) 


1C495606) 


ADULT 


{ TASK POINTER OF PARENT } 




103B56O6) 


CHILD 


{ TASK POINTER OF CHILD } 




0(16) 


STACK 


{ ADDRESS OF CURRENT STACK SEGMENT ) 


1CD97806) 


STATE 


{ CURRENT STATE } 


WAIT FOR ANY MESSAGE 


PRIORITY 


{ ACTUAL PRIORITY } 




1 


EXPRESS ITM 


{ NUMBER EXPRESS lNTER.TASK MSGS QUEUED } 


0(10) 


NORMAL ITM 


{ NUMBER NORMAL lNTER.TASK MSGS QUEUED } 


0(10) 


SR 


{ STATUS REGISTER > 








TRACE MODE 


NO 






M68000 MODE 


USER 






INTERRUPT MASK 


000 






RESULT EXTENDED 


NO 






RESULT NEGATIVE 


NO 






RESULT ZERO 


NO 






OVERFLOW 


NO 






CARRY 


NO 




PC 


{ PROGRAM COUNTER } 




10A774O6) 


A6 


{ STACK POINTER ) 




1CE21C06) 


A7 


{ STACK POINTER ) 




1CE21C06) 




MODULE NAME 


EXEC.PMM 






OFFSET IN CODE SECTION 


142(16) 




OWNER.ID 


{ ID GENERATED FOR MEMORY OWNERSHIP } 


F01DO6) 



The following subcommand displays summary information for all TCBs: 
DISTCB TI=ALL DO=BRIEF 

Output from this subcommand is formatted as follows: 

TASK CONTROL BLOCK DISPLAY 



TASK NAME 


TCB ADDRESS 


A6 PRIORITY STATE 


SYSTEM.ANCESTOR 


103B56I 


1044221 


7IWAIT FOR MSG 


INITIAL IZATION_M_E 


1D27B2I 


27E056I 


31 WAIT FOR MSG 


INDEPENDENT_LOG_ME 


20CA8CI 


211CB4I 


4IWAIT FOR MSG 


IVT.GATEWAY 


20D2DCI 


20E35EI 


5IWAIT FOR MSG 


TERMINAL_SUPPORT_BOUND 


200EA0I 


2018FAI 


5 WAIT FOR MSG 


LINE.CONTROL .BOUND 


2004D4 | 


200DE8I 


31 WAIT FOR MSG 


NPJ3ATEWAY 


1E7FECI 


1E90A8I 


5IWAIT FOR MSG 


K J> ISPLAY.SUPERV ISOR 


1DE294I 


1DE7DCI 


3IWAIT FOR MSG 


OPERAT0R_SUPPORT_APPL ICAT ION 


1DD5AAI 


1DE1EAI 


31 WAIT FOR MSG 


INDEPEM>ENT_FILE_ACCESS_ME 


1D297AI 


1D32AEI 


3! WAIT FOR MSG 


MCI.SSR 


1C4E16I 


1D0426I 


51 WAIT FOR MSG 


SERVICE.MODULE 


106E1AI 


10774EI 


51 WAIT FOR MSG 


XEROX_INTERNET_ROUTINES 


1C4C02I 


1CF410I 


1 1 WAIT 



NOTE 



All numeric values in the BRIEF display are in hexadecimal. 
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DISPLAYJTREE (DIST) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



Remarks 



The DISPLAY_TREE subcommand displays a list of linked elements from 
a binary tree structure, beginning at the specified root address. Data is 
displayed node-by-node. A tree may also be searched for a specified key, 
using the SEARCH _KEY parameter. 

DISPLAY_TREE 

ADDRESS = address or entry point name 
SEARCH _REY = integer, name, or string 
OUTPUT = file^name 
STATUS = status ^.variable _name 

ADDRESS (A) 

This required parameter specifies the root address of the binary tree 
structure. The value may be a DI memory address or an externally defined 
entry point name. Entry point names can be found by using the DISPLAY_ 
MEMORY_MAP subcommand described in this chapter. 

SEARCH _KEY (SK) 

This parameter specifies the node key to be searched for. If a match is 
found, only the data for that node is displayed; otherwise, a message is 
issued indicating that no match was found. If SEARCH _KEY is specified, 
its type must match the tree type. 

If SEARCH _KEY is omitted, no key search is performed, and the entire 
tree is displayed. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is not specified, the output file name on the ANACD command 
is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

It is assumed that the tree being searched is sorted in key order Qeft link 
low) and contains no duplicate keys. No checks are made on these 
conditions during tree display. 
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Examples The DISPLAY_TREE subcommand shown below displays a loader entry 
point tree structure with a root address of 108524(16). 

DIST 108524 CNTREEOUT 

Output from this subcommand is formatted as follows: 

Tree Identifier » eptb 
Number of Nodes in Tree - 809 
Tree Kind = string 

Node 1 of 809 ( 73 bytes): key ■ ABORTASK. 

109F72 4142 4F52 5441 534B 5F20 2020 2020 2020 ABORTASK. 

109F82 2020 2020 2020 2020 2020 2020 2020 20D6 

109F92 0010 AD12 0010 AC54 0000 002C 0000 0000 T 

109FA2 0010 9EAC 0000 0000 0000 0000 0000 0004 

109FB2 0072 0050 0010 A178 00 r P x 

Node 2 of 809 ( 73 bytes): key ■ ABORTJilESSAGE 

109F72 4142 4F52 5441 534B 5F20 2020 2020 2020 ABORT MESSAGE 

109F82 2020 2020 2020 2020 2020 2020 2020 20D6 

109F92 0010 AD12 0010 AC54 0000 002C 0000 0000 B 

109FA2 0010 9EAC 0000 0000 0000 0000 0000 0004 « z 3{ 

109FB2 0072 0050 0010 A178 00 TB 'x8 x 

Node 3 of 809 ( 73 bytes): key « ABORT.SYSTEM 

109F72 4142 4F52 5441 534B 5F20 2020 2020 2020 ABORT SYSTEM 

109F82 2020 2020 2020 2020 2020 2020 2020 20D6 V 

109F92 0010 AD12 0010 AC54 0000 002C 0000 0000 B 

109FA2 0010 9EAC 0000 0000 0000 0000 0000 0004 R8 w - 

109FB2 0072 0050 0010 A178 00 



NOTE 



If the structure you attempt to display is not a tree structure, the Dump 
Analyzer responds with error message number 136. 
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HELP (HEL) 
ANACD Subcommand 



Purpose 



Format 



Parameters 



The HELP subcommand displays either a list of all Dump Analyzer 
subcommands available to the user, or detailed parameter information 
about a specified Dump Analyzer subcommand. 

NOTE 



This subcommand, as described below, is only available on NOS. If you are 
using the Dump Analyzer under NOS/VE, HELP invokes the SCL 
command that accesses online manuals. 



HELP 

COMMAND _NAME = name 

OUTPUT = file_name 

STATUS = status _variable _name 



COMMAND _NAME (CN) 

This parameter specifies the name of the Dump Analyzer subcommand for 
which parameter information is to be displayed. The specified value may be 
the full name of a Dump Analyzer subcommand, or any of its 
abbreviations. If the specified subcommand name cannot be found, a 
warning message is issued with no further display. 

If the COMMAND _NAME parameter is omitted, then a display listing all 
available Dump Analyzer subcommands is produced (this is equivalent to 
entering DISCL,DO=B). 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is not specified, the output file name on the ANACD command 
is assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples The following subcommand displays a list of all currently available Dump 
Analyzer subcommands: 

HELP 

Output from this subcommand is formatted as follows: 

ANACD COMMAND LIST 



DISPLAY_AUTO_DUMP_TABLE 

DISPLAY_BUFFER_CHAIN 

DISPLAY_COMMAND_INFORMATION 

DISPLAY_DATA_QUEUE 

DISPLAY_EXECUTIVE_ERROR_TABLE 

DISPLAY_LINKED_LIST 

DISPLAY_LOG_QUEUES 

DISPLAY_MEMORY_HEADER 

DISPLAY_MEMORY_USERS 

DISPLAY_PROGRAM_VALUE 

DISPLAY_TASK_CONTROL_BLOCK 

HELP 

SELECT.TASK 

VALIDATE_STACK_AREAS 



DISPLAY_BOARD_MAP_TABLE 

DISPLAY.CALLS 

DISPLAY_COMMAND_LIST 

DISPLAY_DI_SYSTEM_STATUS 

DISPLAY_HARDWARE_STATUS 

DISPLAY_LINE_CONTROL_BLOCK 

DISPLAY.MEMORY 

D I SPLAY.MEMOR YJYIAP 

DISPLAY_NETWORK_STATUS 

DISPLAY_SYSTEM_CONFIG_TABLE 

DISPLAY_TREE 

QUIT 

VALIDATE_GLOBAL_INFORMATION 



The following subcommand displays information about the DISPLAY. 
MEMORY subcommand: 

HEL DISM 

Output from this subcommand is formatted as follows: 



ADDRESS, A 
BYTE.OFFSET, BO 
BYTE.COUNT, BC 
REPEAT_COUNT, RC 
OUTPUT, 
STATUS 



any = $requ1red 

Integer .. 7FFFFFFF(16) = 

integer 1 .. 7FFFFFFF(16) = 1 

integer 1 .. 7FFFFFFF(16) or key ALL = 1 

name = Soptlonal 

name = Soptlonal 
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QUIT (QUI) 

ANACD Subcommand 

Purpose This subcommand terminates the Dump Analyzer session and returns 
control to the caller or operating system (NOS/VE or NOS). 

Format QUIT 

STATUS = status _variable _name 

Parameters STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Remarks Under NOS/VE, an end-of-information (EOI) on an input file produces the 
same result as the QUIT subcommand does interactively. Under NOS an 
EOI, end-of-record (EOR), or end-of-file (EOF) on an ANACD input file 
produces the same result as the QUIT subcommand does interactively. 
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SELECT JTASK (SELT) 
ANACD Subcommand 

Purpose This subcommand specifies the task that is to be examined in subsequent 
DISPLAY_CALL or DISPLA.Y_.TASK .CONTROL _BLOCK subcommands. If 
SELECT_TASK is not used to specify a task, the task that was running 
when the DI was reset is assumed as the current task. 

Format SELECTJTASK 

TASK JJDENTIFIER = address or task_name 
— STATUS = status _variable _name 

Parameters TASK .IDENTIFIER (TI) 

If this parameter specifies an address, then it is interpreted as the first 
byte address of the Task Control Block (TCB) for the task selected to be 
the current task. If a task name is specified, then a TCB is sought with 
that name; if more than one TCB is found for that task, a warning is 
issued and there is no change in the current task. 

NOTE 

The only unique identification of a task for dump analysis purposes is the 
TCB address. A task name (taken from the module name when the task is 
scheduled) might be associated with more than one TCB. An attempt to 
select a task by task name is rejected if the task name is not unique. 

If no TASK_IDENTIFIER is specified, the task that was running at the 
time the DI was reset is made the current task. If there was no task 
running when the DI dumped its memory, then Dump Analyzer error 
message number 94 is issued. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Examples The following subcommand causes the task with its TCB at address 
10FFFE(16) to be selected as the current task: 

SELECTJTASK TASK_IDENTIFIER=10FFFE 

The following subcommand causes the task EXEC_MPB (provided it has 
only one scheduled instance in the dump) to be selected as the current 
task. 

SELT TI=EXEC_MPB 

The following subcommand causes the task that was executing when the DI 
was reset to be selected as the current task (provided there was a task 
running when the DI dumped its memory): 

SELT 
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VALIDATE .GLOBAL .INFORMATION (VALGI) 
ANACD Subcommand 



Purpose 



This subcommand displays general information that can serve as a 
preliminary guide to further analysis. This information includes suspended 
tasks, tasks with overwritten stacks, modules with code present in a dump, 
and tasks in excess of 30 ITMs queued. It also validates memory chains 
and task chains. 



Format VALID ATE .GLOBAL INFORMATION 

OUTPUT = fde_name 

STATUS = status ^.variable _name 

Parameters OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 



Remarks 



Examples 



STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 

Execution time for this subcommand is typically longer than for other 
subcommands. Display is output slowly. 

The generic format of VALGI output is as follows: 

VALIDATE GLOBAL INFORMATION 

Reset code = xx : xxxxxxxxxxxxxxxxxx 

Date and time of reset • yy/mm/dd hh.mm.ss.msec 

Date and time of last reload • yy/mm/dd hh.ira.ss.msec 

Running task ■ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, TCB address ■ xxxxxxxx(fj) 

*or 'No task was running at time of reset'* 

Abort message: 

■"String from abort.system if not blanks* 



Suspended Tasks: 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxx(1B> 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxx(16) 

Task(s> with overwritten stack: 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxx(16) 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxx(16) 



"task name / TCB addrss* 
OR 'none' 



«task name / TCB addrss* 
OR 'none' 



Module(s) with code present in dump 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



possible invalid checksum: 
•module name* OR 



'noe' 



Task(s) with excess of 30 ITM's queued: 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxxOS) 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx / xxxxxxx(16) 



•task name / TCB addrss> 
OR 'none' 
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VAUDATE JH.OBALJNFORMATION (VALGI) 

The following subcommand writes VALGI output to file VALGOUT: 

VALIDATE_GLOBAL_INFORMATION OUTPUT-VALGOUT 
Display from this subcommand is formatted as follows: 

VALIDATE GLOBAL INFORMATION 

Reset code « 32 •. kill.system_with.dump 

Date and time of reset = 86/11/21 15. 02. 53. 700 

Date and time of last reload ■ 86/11/21 15.01.51.333 

Running task = EMAL.TEST , TCB address " 139244(16) 

Abort message: 

emal7 release descriptor failed 

Suspended Tasks: 
None 

Task(s) with overwritten stack: 
None 

Module(s) with code present in dump - possible invalid checksum: 
None 

Task(s) with excess of 30 ITMs queued: 
None 

NOTE 

Ordinarily, a DI code module (any module built for READ or 
READ/EXECUTE only) is written to the dump file only if it is found to 
have a bad checksum. However, when checksum information for modules is 
not available, all memory is dumped. 

In this situation, the list of code modules in the dump file can be quite 
long, even though the listed modules do not necessarily have bad 
checksums. 
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VALIDATE _STACK_AREAS (VALSA) 
ANACD Subcommand 

Purpose This subcommand checks the integrity of the user stack and reserved stack 
areas and indicates whether or not these areas have been written into. 

VALSA also checks the Task Control Block (TCB) chain and reports the 
first address at which the chain is broken. If a break is detected, VALSA 
then searches all of system main memory (SMM) and reports the addresses 
at which the TCB identifier (!TCB) was found. 

Format VALIDATE ..STACK .AREAS 

TASK JDENTLFIER = address, task_name, or keyword 

DISPLAY JOPTION = keyword 

OUTPUT = file_name 

STATUS = status _variable _name 

Parameters TASK IDENTIFIER (TI) 

If this parameter specifies an address, then it is assumed to be the address 
of a TCB. VALSA validates the stack areas associated with that TCB. If 
this parameter specifies a task name, all TCBs scheduled for that task are 
processed. The keyword ALL causes VALSA to process the entire TCB 
chain, beginning with the system ancestor task. 

If TASK .IDENTIFIER is omitted, VALSA processes the entire TCB chain, 
beginning with the system ancestor task. 

DISPLAY JOPTION (DO) 

This parameter specifies the extent of information to be displayed. If the 
keyword FULL (or EXPANDED) is specified, all stack penetration data for 
the TCBs specified by the TASK .IDENTIFIER parameter are displayed. If 
BRIEF (or SUMMARY) is specified, then only a summary of the stack 
areas of questionable integrity is displayed. 

If DISPLAY.OPTION is omitted, then the value BRIEF is assumed. 

OUTPUT (O) 

This parameter specifies the name of the file to which the subcommand 
output is written. This file may be any valid path name on NOS/VE. 
Under NOS, this file is local. 

If OUTPUT is omitted, the output file name on the ANACD command is 
assumed. 

STATUS 

This parameter is the standard NOS/VE SCL status variable. Under NOS, 
the STATUS parameter is checked for correct syntax but is not operational. 
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Examples The following subcommand makes all stack area checks and writes output 
to file MYLIST. 

VALIDATE_STACK_AREAS DISPLAY_OPTION=FULL OUTPUT=MYLIST 

Display from this subcommand is formatted as follows, with one stack 
usage and penetration summary displayed for each TCB in the TCB chain: 

STACK USAGE AND PENETRATION SUMMARY 

TASK CONTROL BLOCK ADDRESS 13BE8A(16) 
TASK NAME SYSTEM.ANCESTOR 

STACK BEGINS AT ADDRESS (LOW MEMORY) 13B57C(16) 

STACK ENDS AT ADDRESS (HIGH MEMORY) 13BE6C(16) 
RESERVED STACK AREA 

SPACE ALLOCATED F0(16) BYTES 

STARTING ADDRESS ( LOW MEMORY) 13B57C06) 

ENDING ADDRESS (HIGH MEMORY) 13B66B(16) 
USER STACK AREA 

SPACE ALLOCATED 8F0(16) BYTES 

STARTING ADDRESS ( LOW MEMORY) 13B66C(16) 

ENDING ADDRESS (HIGH MEMORY) 13BE6B(16) 
STACK PENETRATION DATA 

PENETRATION DEPTH 1D7(16) BYTES 

STARTING ADDRESS (HIGH MEMORY) 13BE6B(16) 

ENDING ADDRESS ( LOW MEMORY) 13BC94(16) 

The following message appears before the stack usage and penetration 
summary for a task that has overflowed its stack area: 

OVERFLOW IN RESERVED STACK AREA AT ADDRESS xxxxxxx 

where xxxxxxx is the hexadecimal address at which the overflow occurred. 

The following subcommand writes a summary of all stack areas of 
questionable integrity to file MYLIST: 

VALSA DO=B O-MYLIST 

Output from this subcommand appears in one of two forms. If no 
corruption of the reserved stack area is detected, then the following 
message is issued: 

Specified reserve stack areas have passed penetration checks. 
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The following display identifies the tasks with reserved stack area 
corruption. 

SUMMARY LIST OF TASKS WITH STACK CORRUPTIONS 



Task Name TCB Type of Stack Corruption 

Address 



system_ancestor_task | 103457 | Overflow area penetrated 

cmd_d1splay_transport_status I 1A0093 I Overflow area penetrated 

1tm_timer | 1C7300 I A6 out of range 

update.nsl | 2AAA00 I Overflow area penetrated 



NOTE 



Error messages (if any) are dispersed throughout the display and identify, 
by TCB address, the task(s) with errors. 



The following subcommand displays summary stack penetration information 
regarding any TCBs associated with the task named ITM_TIMER. 

VALSA TI=ITM_TIMER 

If no corruption of the reserved stack(s) for ITM_TIMER task(s) is 
detected, the following message is displayed: 

Specified reserve stack areas have passed penetration checks. 

Display from this subcommand is formatted as follows if a corruption in 
the stack(s) of ITMJTIMER task(s) is detected: 

SUMMARY LIST OF TASKS WITH STACK CORRUPTIONS 



Task Name TCB Type of Stack Corruption 

Address 



1tm_t1mer | 1C7300 I A6 out of range 
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ADT 

Refer to Auto Dump Table. 

Alarm 

A log message that is routed to an operator. Any CDCNET log message may be 
designated as an alarm. 

Alarm History 

A chronological record of the alarms received at a network operator's alarm buffer 
since the start of an operations session. An alarm history may be displayed using a 
network operations command. 

American Standard Code for Information Interchange (ASCII) 

A standard code, using a coded character set consisting of 7-bit coded characters (8 bits 
including parity check), used for information interchange among data processing 
systems, data communication systems, and associated equipment. The ASCII set consists 
of control characters and graphic characters. 

ASCII 

Refer to American Standard Code for Information Interchange. 

Asynchronous TIP 

The terminal interface program (TIP) that configures terminal devices and establishes 
terminal attributes for a generic, asynchronous terminal connected to a device interface. 
The asynchronous TIP resides in a device interface that is configured to support 
asynchronous terminals. 

Auto Dump Table (ADT) 

A data table that is constructed when a device interface resets. The ADT is part of the 
dump file, and contains control information about the remainder of the file. The Dump 
Analyzer program uses the ADT to interpret the dump file. 

B 

Batch Device 

Individual devices in an I/O station controlled by batch services and protocols and used 
for batch input and/or output. Examples of batch devices include card readers, line 
printers, card punches and plotters. 

Block 

In the context of network communications, a portion or all of a message. A message is 
divided into blocks to facilitate buffering, transmission, error detection, and correction 
for variable-length datastreams. Differing block protocols apply to the host-to- device 
interface and the device-interface-to-terminal interfaces. 

During input from a terminal, a block is a single transmission consisting of one or 
more lines of one or more messages. 
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During input to a service, a block is a single line consisting of part or all of a 
message. Terminal transmission blocks are divided into as many service input blocks as 
needed, until the message is completed. 

During output from a host application program, a block is one or more lines. During 
output from a device interface to a terminal, a block is one terminal transmission 
buffer. 

A protocol data unit (PDU) between the peripheral processor and the channel interface. 

Board 

Refer to Logic Board. 

Boot File 

On NOS, the boot file contains the basic set of software that is loaded into a device 
when the device interface requests to be loaded. A boot file brings a device interface 
up to a basic operational state. Further definition of the device interface's functions is 
provided by its system configuration file. 

On NOS/VE, individual boot files do not exist. Rather, a set of boot software exists for 
each software version in the object library. 

Buffer 

One of two structures for the storage of data in device interface memory. See also Data 
Buffer and Descriptor Buffer. 

Buffer Chain 

If a message cannot be recorded into a single data buffer, additional data buffers are 
assigned and chained to the current buffer until the entire message is contained in the 
buffer chain. 

Byte 

1. (ISO) A binary character string operated upon as a unit and usually shorter than a 
computer word. 

2. (ISO) A group of contiguous bits. Unless prefixed (for example, a 6-bit byte), the 
term implies 8-bit groups. An 8-bit byte is sometimes called an octet. When used 
for encoding character data, a byte represents a single character. 



Catenet 

Refer to Concatenated Network. 

A group of connected CDCNET network solutions. This term is often used when 
referring to all the device interfaces and network solutions in a site's network. 

CCL 

Refer to CYBER Control Language. 

CDCNET 

Refer to Control Data Distributed Communications Network. 

CDNA 

Refer to Control Data Network Architecture. 
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Central Processor Unit (CPU) 

The high-speed arithmetic processing unit that carries out the basic instructions 
required in program execution. 

Channel 

The physical link or logical path between a Mainframe Device Interface (MDI) and the 
network host computer, or between an Integrated Communication Adapter (ICA) and 
the Integrated Controller Interface (ICI) in the network host computer. 

Character 

Any alphabetic, numeric, or special symbol that can be encoded. This term applies to 
the graphic characters for a terminal input or output device and to the encoded control 
characters used by the terminal. Within Control Data hardware, a character is a coded 
byte of data, such as a 6-bit display code (NOS only) or 7-bit ASCII code. 

CIM 

Refer to Communications Interface Module. 

CLCB 

Refer to Configured Line Control Block. 

Clock Synchronization 

A function that ensures that all device interfaces in a catenet are synchronized within 
1 second of each other. Clock synchronization involves setting or resetting the master 
clock for the catenet (controlled by the Independent Clock ME) and synchronizing all of 
the device interface clocks in the catenet (controlled by the Dependent Clock ME in 
each device interface) according to the master clock. The DEFINE _SYSTEM command 
defines whether or not a device interface contains the Independent Clock ME. 

On NOS, the device interface that contains the Independent Clock ME contains the 
master clock for the catenet, which synchronizes the rest of the clocks in the network. 

On NOS/VE the Independent Clock ME is configured on the host. 

Code Set Procedure 

A CDCNET load procedure that allows a site to define its own code sets for input and 
output devices. 

Command File 

A NOS file of network operations commands. Commands in the command file can be 
executed using the EXECUTE .COMMAND ..FILE. Similar to a procedure file. 

Communication Line 

A terminal line that establishes a complete communication circuit between a terminal 
or workstation and a CDCNET device interface. 

Communications Interface Module (CIM) 

The logic board within a CDCNET device interface that controls transmissions between 
the line interface module (LIM) bus and the internal system bus (ISB). 

Computer Network 

A linked collection of data processing and communications equipment. 
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Concatenated Network (Catenet) 

A communications network composed of more than one type of communications medium 
(more than one network solution); often established when it is necessary to interconnect 
a local area network (LAN) with other resources (for example, another local area 
network, or geographically remote computer-related resources). Also called a catenet. 

Configuration 

The process by which various computer-related resources are coordinated to function 
together. Under CDCNET, various types of configuration activities are performed. 

1. Network configuration, whereby hosts, terminals, workstations, and unit record 
devices are interconnected into a network using CDCNET device interfaces and 
appropriate communications media. 

2. Device interface hardware configurations, whereby decisions are made regarding 
which logic boards to install in a particular CDCNET device interface. 

3. Device interface software configuration, whereby CYBER hosts decide which 
CDCNET software to downline-load into a specific CDCNET device interface. 

4. Creation of device interface configuration files, whereby network adnunistrators or 
communications consultants identify/describe the specific CDCNET device interfaces 
that reside in their networks and place this information in host-maintained 
permanent files. 

See also Logical Configuration. 

Configuration Command 

A command that establishes, cancels, or redefines the configuration of a network 
component in the network's logical definition. 

Configuration File 

Refer to Configuration Procedure. 

Configuration Procedure 

A procedure containing configuration commands that configure the software in a device 
interface. Each device interface has a unique configuration file, which is read whenever 
the device interface is reset and loaded. Also known as configuration file. 

Configured Line Control Block (CLCB) 

A data structure used by the device interface to maintain information about its defined 
communication lines. 

Congestion 

A condition in which there is more message traffic on a network solution or 
communication line than the line's carrying capacity. Continued congestion results in 
lengthy message delay and discarding of new messages. 

Connection-Oriented Network Service (CONS) 

OSI connection oriented network service specification used in conjunction with X.25. 

Connection Timeout 

The service connection is discontinued after a specified length of inactivity. 
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CONS 

See Connection-Oriented Network Service. 

Control Data Distributed Communications'/ Network (CDCNET) 

1. The collection of compatible hardware and software products offered by Control Data 
to interconnect computer resources into distributed communications networks. 

2. A network that is interconnected by Control Data Network Architecture 
(CDNA)- compatible hardware and software products. 

Control Data Network Architecture (CDNA) 

The network architecture designed by Control Data. CDNA follows the lower layer 
recommendations of the International Standards Organization's (ISO) Open System 
Interconnection (OSI) reference model. 

CPU 

Refer to Central Processor Unit. 

CRC 

Refer to Cyclic Redundancy Check. 

CYBER Control Language (CCL) 

A language that allows you to insert a set of statements into the control statement 
section of your job. It also provides a means for you to determine the status of files, 
initiate tests and transfer within the control statement section, and display results in 
your dayfile. 

CYBIL 

Primary implementation language for NOS/VE computer systems and CDCNET 
software. 

Cyclic Redundancy Check (CRC) 

A check code transmitted with blocks of data. This code is used by several protocols. 

D 

Data Buffer 

A structure for storing user data in device interface memory. A pointer is associated 
with the first character of data in the buffer. Data buffer length is configurable. 
Contrast with Descriptor Buffer. 

Data Circuit-Terminating Equipment (DCE) 

1. In a data station, the equipment that provides the signal conversion and coding 
between the data terminal equipment (DTE) and the line in a data station. The 
DCE may be separate equipment or an integral part of the DTE or of intermediate 
equipment. The DCE may perform other functions that are normally performed at 
the network end of the line. 

2. The hardware that links data terminating equipment (DTE) to communications 
media. Data communications equipment is normally a modem or modem equivalent 
(data set). 
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Data Communication 

The interchange of data messages from one point to another over communications 
channels. 

Data Terminal Equipment (DTE) 

1. That part of a data station which serves as a data source, data sink, or both. 

2. Data communications equipment that allows human interaction with the databases 
and operations of a network. 

DCE 

Refer to Data Circuit-Terminating Equipment. 

DCNS 

Refer to Distributed Communications Network Software. 

Deadman Timeout (DMTO) 

A device interface hardware reset that occurs automatically if software does not work 
normally for 10 seconds. 

Dedicated line 

A communication line that permanently connects a terminal to a device interface 
Contrast with Switched Line. 

Default 

A pre-selected value supplied for a missing parameter upon the entry of a command or 
subcommand. 

Default Parameter Settings 

The command parameter values to be assumed when no alternate values are supplied 
by the user. 

Dependent Log ME 

Refer to Log Management Entity. 

Descriptor Buffer 

A data structure used for chaining data buffers. Contrast with Data Buffer. 
Device Interface (DI) 

The communications processor that Control Data offers as its CDCNET hardware 
product. Also called a CDCNET device interface. 

Device Interface Dump Analyzer 

Host-resident software that processes device interface dump files. 

Device Interface Resident Debugger (DIRD) 

A software utility that enables software developers to debug their own CDCNET 
software. The DIRD is controlled from an interactive terminal connected to the device 
interface's main processor board (MPB). 

DI 

Refer to Device Interface. 
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DI Name Resolver 

A program that resides in a DI and provides an interface between the DI and domain 
name servers. If a TCP/IP user specifies a domain name, the name resolver requests a 
domain name server to translate the name into the corresponding IP address. 

Diagnostic 

1. Software and/or microcode that isolates failing hardware/software components within 
a CDCNET device interface. 

2. A message indicating a malfunction within a CDCNET device interface or one of its 
related communications media. 

Diagnostic Management Services (DMS) 

The device interface maintenance software that provides support to the device interface 
software and the online diagnostics. 

Dial-up Line 

A communications circuit created by dialing a destination over a common carrier's 
switched lines. 

DIRD 

Refer to Device Interface Resident Debugger. 

Disabled 

Cannot be used for normal network operation. Applies to boards, communication lines 
and network solutions. 

Distributed Communications Network Software (DCNS) 

The software that executes in a device interface as part of the CDCNET product. 

DMS 

Refer to Diagnostic Management Services. 

DMTO 

Refer to Deadman Timeout. 

DOD 

Department of Defense. 

Domain Label 

Part of a domain name and contains up to 63 characters. The label must begin with a 
letter (A..Z or a..z), which can be followed by letters, digits, or hyphens. The label 
must end with a letter or a digit. 

Domain Name 

TCP/IP users typically use domain names instead of IP addresses to reference TCP/IP 
services. Domain names identify hosts or other resources connected to a TCP/IP 
network. A domain name consists of a sequence of domain labels, arranged in a 
hierarchical order, and separated by periods. For example, the name 
PINK.ARH.CDC.COM, could specify a machine called PINK at the Arden Hills (ARH) 
facility of Control Data, which is a commercial organization (COM). The length of a 
domain name including the separating periods can be up to 255 characters. 
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Domain Name Server 

A program that resides in a host connected to the TCP/IP network and responds to 
queries for information about domain names. 

Down 

A status of suspended service. 

DTE 

Refer to Data Terminal Equipment. 

Dump 

Refer to Memory Dump. 

Dump Analyzer 

CDCNET troubleshooting software that enables communications support analysts to 
review detailed memory dumps generated by malfunctioning CDCNET device interfaces 
Refer to Analyze _CDCNET_Dump (ANACD). 

E 

Entry Point 

A machine address corresponding to the start of the executable code in a software 
routine. Each externally declared (XDCLed) variable in the CYBIL source code of the 
software running in a device interface has a corresponding entry point in device 
interface memory. 

ESCI 

Refer to Ethernet Serial Channel Interface. 

Ethernet 

A baseband local area network protocol developed by the Xerox Corporation. CDCNET 
supports an Ethernet- compatible network. 

Ethernet Serial Channel Interface (ESCI) 

The logic board within a CDCNET device interface that controls transmissions between 
an Ethernet (IEEE 802.3) transceiver and the internal system bus (ISB) of the device 
interface. 

Exception List 

A file that determines how to process the load requests of the network's device 
interfaces (DIs). The exception list is a file of commands that specify the version of 
software to be loaded into the device interface, and which error codes should trigger a 
dump of the device interface memory. There is one exception list for the network, 
containing a default entry and any exceptions to the default entry. 



Forms Code 

A 1- through 6-character identifier associating a print file with a certain printer form 
ensures output will be routed to a printer which prints in the format needed. For 
example, one printer at a site can be defined as using an 8-1/2 by 11-inch print form 
by specifying a forms code of DOC (document) on the command that configures the 
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printer (DEFINE _BATCH .DEVICE). Another printer can be defined to print 
perforated checks and have a forms code of CHECKS, and one defined to print on 
carbon paper could have a forms code of CARBON. When output is routed to printers, 
the appropriate forms code (DOC, CHECKS, or CARBON) can be specified so that 
output will be printed by the appropriate printer. 

G 

Gateway 

A software interface between systems with different architectures and protocols. 

H 

HASP 

Refer to Houston Automatic Spooling Program. 

HDLC 

Refer to High-Level Data Link Control. 

High-Level Data Link Control (HDLC) 

The International Standards Organization's (ISO) bit- oriented protocol for the data link 
layer of the Open Systems Interconnection (OSI) reference model. 

Host Computer 

A mainframe computer system, connected to a communications network, which provides 
primary services, such as database access, user application execution, or program 
compilation. For CDCNET, a host computer provides network support functions, 
including maintenance of device interface load files. Also called a host. 

Host Console 

The keyboard and display screen used to manage the host computer. Also used in 
CDCNET to access the Network Operator Utility (NETOU) to monitor and control the 
CDCNET. See also System Console. 

Host Operating System 

The host containing applications and maintenance software available to the device 
interface. 

Host Service Name 

A logical name for the host computer. The host service name is the name that 
terminal users provide when connecting to the host using the CREATE .CONNECTION 
command. 

Houston Automatic Spooling Program (HASP) 

A job control protocol for transmitting data processing files and jobs between certain 
models of computers. 
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I/O Station 

A logical grouping of batch devices into a single named unit for routing jobs and files 
to the batch devices and for controlling the devices. Devices belonging to an I/O station 
may all connect to the same line, to several lines on one device interface, or to lines 
distributed among several device interfaces. 

ICA 

Refer to Integrated Communications Adapter. 

ICA Channel Interface (ICI) 

The ICI is the I/O subsystem in the ICA that interfaces to a CYBER 180 channel. 

ICA Ethernet Interface (IEI) 

The IEI is the I/O subsystem in the ICA that interfaces to the Ethernet. 

ICI 

Refer to ICA Channel Interface. 

IEI 

Refer to ICA Ethernet Interface. 

IFA 

Refer to Independent File Access. 

Independent File Access (IFA) 

1. A service in some device interfaces that may access files in secondary storage on 
NOS host computers with the help of the host application called File Server. Only 
mainframe device interfaces (MDI) or mainframe terminal device interfaces (MTI) 
may contain an Independent File Access service. 

2. A service on NOS/VE host computers that provides access to files in secondary 
storage. 

Independent Log Management Entity (Independent Log ME) 

1. Also known as the recorder logging function. Software resident in a host- connected 
device interface that works with the Independent File Access ME to write log 
messages generated by network device interfaces to a file on a host called the 
network log file. 

2. A service on NOS/VE host computers that writes log messages generated by 
network device interface to a host-resident file called the network log file. 

Information Processing Family Version 2 (IPF2) 

A CDC host product used by CDCNET to generate Network Performance Analyzer 
(NPA) reports. 

Initialization Procedure 

A CDCNET load procedure that defines data to be sent to a printer when the printer's 
communication line becomes active. 
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Integrated Communications Adapter (ICA) 

A hardware device that interconnects a single 16-bit Integrated Controller Interface 
(ICI) channel of a host computer with CDCNET. The ICA is installed in the CYBER 
930 series host computer mainframe. 

Interface 

A mechanism that enables the exchange of data between two dissimilar resources in a 
communications network. 

International Standards Organization (ISO) 

A worldwide standards group similar in function to the American National Standards 
Institute (ANSI). ANSI is a member of International Standards Organization. 

Internet Protocol (IP) 

A term used in DDN networks that refers to a connectionless, point-to-point protocol 
corresponding to the CDCNET Internet layer. This protocol is required for connection 
to MILNET, ARPANET, and TCP/IP workstations. 

IP 

Refer to Internet Protocol. 

IP Address 

Internet Protocol (IP) uses a 32-bit IP address field containing the Internet Address. 
Each IP system or host in the DDN is assigned a unique IP address. A host may have 
one or more IP addresses; however, a CDC CYBER host basically supports only one IP 
address per host. 

IPF2 

Refer to Information Processing Family Version 2. 

ISO 

Refer to International Standards Organization. 

K 

K Display 

A NOS host console display that enables operators to interact with various operating 
system utilities (for example, those controlling user validation and NAM subsystem 
interaction). 



LAN 

Refer to Local Area Network. 

LCM 

Refer to Line Control Module. 

LCSM 

Refer to Line Control Support Module. 
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LIM 

Refer to Line Interface Module. 

Line 

A circuit that connects a terminal to a device interface. A line is dedicated to carrying 
data to and from that terminal. It does not carry data that is routed through the rest 
of the network, nor does it use the CDNA protocol. Also known as a communication 
line. 

Line Control Module (LCM) 

CDCNET software that processes line and terminal configuration commands, and 
monitors line and terminal activities. 

Line Control Support Module (LCSM) 

CDCNET software that enables communications lines and performs autorecognition. 

Line Interface Module (LIM) 

A smaller logic board within a CDCNET device interface that enables the device 
interface to be attached to terminal, workstation, and unit record equipment lines. 

Link 

1. Any specified relationship between two device interfaces in a network, or a 
communication path between two device interfaces, or a data link. 

2. The communications path between two device interfaces. Also called a line, channel, 
or circuit. 

Load Procedure (LP) 

A file containing commands specifying information to be downloaded to a printer. Load 
procedure types include initialization procedures (IPs), file prefix procedures (PPPs), 
code set procedures, and VFU load procedures (VLPs). 

Local Area Network (LAN) 

A privately owned communications network that interconnects computer-related 
resources. Typically, the resources interconnected by this network are confined to a 
relatively concise geographic area, such as a single building. 

Log File 

A file that is created and maintained by the operating system for storing error 
information and usage data concerning network elements. 

Log Management Entity (Log ME) 

Software that manages the transmission and recording of log messages generated by 
device interface software. Consists of Dependent and Independent Log Management 
Entities. Dependent Log Management Entities, residing in device interfaces, are sources 
of log messages. Independent Log Management Entities, residing in a host- connected 
device interface, work with host applications or a NOS/VE host to write the log 
messages to the network's log file on the host. 

Log ME 

Refer to Log Management Entity. 
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Logic Board 

A printed circuit board with data storage and/or processing components installed; 
sometimes called a board, card, or module. 

Logical Configuration 

The process of assigning names and values and setting variables throughout the 
CDCNET to define network elements (mainframes, terminals, lines, network solutions, 
device interfaces, gateways, and other elements), so that all network elements follow a 
uniform naming and addressing scheme. After logical configuration, network elements 
accept all data and commands directed to or through themselves, and reject all other 
data and commands. Also known as network definition. 

Logical Link Control 2 (LLC2) 

OSI connection-oriented data link protocol utilized by CONS/X.25 when running over 
ESCI. 

Logical Name 

A name assigned to a CDCNET component (device interface, network solution, 
communication line, gateway) in the logical definition of the network. Many network 
operations commands refer to CDCNET components by their logical names. Contrast 
with Title. 

Logical Unit (LU) 

A 3270 terminal device from which a 3270 terminal interface program (TIP) accepts an 
interactive session. 

LP 

Refer to Load Procedure. 

LU 

Refer to Logical Unit. 

M 

Main Processor Board (MPB) 

The logic board within a CDCNET device interface that provides the primary 
processing power for the device interface. 

Mainframe Channel Interface (MCI) 

An optional logic board within a CDCNET device interface that connects the device 
interface to a 12-bit CYBER host channel. 

Mainframe Device Interface (MDI) 

The CDCNET device interface variant that interconnects a 12-bit channel of host 
computers operating under NOS or NOS/VE with an Ethernet (IEEE 802.3) local area 
network. 

Mainframe/Terminal Device Interface (MTI) 

The CDCNET device interface variant that interconnects 12-bit NOS and NOS/VE host 
computers with terminals, workstations, and unit record equipment without requiring a 
local area network. 
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Maintenance Host 

In CDCNET, a NOS or NOS/VE host responsible for collection of all network errors 
and production of error analysis reports. 

Maintenance Software 

Software designed to perform system tests and diagnostics. All CDCNET maintenance 
software is onboard and online. 

Manage CDCNET Configuration (MANCC) Utility 

A CDCNET host utility for NOS that helps create, edit, and display CDCNET 
configuration files. 

Management Data Unit (MDU) 

A generic data structure used within protocol data units for the expression of variable 
data types. 

Management Entity (ME) 

CDCNET software that performs network management functions. CDCNET supports 
various MEs to perform specific network tasks. 

MANCC 

Refer to Manage CDCNET Configuration Utility. 

MCI 

Refer to Mainframe Channel Interface. 

MDI 

Refer to Mainframe Device Interface. 

MDU 

Refer to Management Data Unit. 

ME 

Refer to Management Entity. 

Memory Dump 

The process and result of writing device interface memory to a host-resident file. 
Memory dumps are forced when the contents of device interface memory are at risk of 
being lost. 

Memory Map 

A listing of loaded software modules and their locations in device interface memory. 
Metrics 

Statistics which are collected and reported for CDCNET hardware and software 
components. 

MILNET 

A Defense Data Network (DDN) evolved from ARPANET that supports operational 
communication requirements. 

MPB 

Refer to Main Processor Board. 
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MTI 

Refer to Mainframe/Terminal Device Interface. 

N 

NAM 

Refer to Network Access Method. 

NAM K Display 

A display on the host console screen that allows operator interface to Network Access 
Method (NAM). A CDCNET operator at the host console communicates with the 
CDCNET through the NAM K display. 

NAM/VE 

Refer to Network Access Method/Virtual Environment. 

NDI 

Refer to Network Device Interface. 

NETCU 

Refer to Network Configuration Utility. 

NETDIR 

The NOS permanent file name of the CDCNET file directory. NETDIR resides under 
user name NETOPS. 

NETFM Utility 

Refer to Network File Manager Utility. 

NETLS 

Refer to Network Log Server. 

NETOPS 

A NOS user name under which files are stored for use during CDCNET installation 
and by CDCNET-host operations. NETOPS contains files created and written by NAM 
while NAM is operating, the network directory file (NETDIR), and the NAMSTRT 
procedure. 

NETOU 

Refer to Network Operator Utility. 

Network 

An interconnected set of host computers, terminals, workstations, and unit record 
equipment. Refer also to Local Area Network and Concatenated Network. 

Network Access Method (NAM) 

The access method that resides under NOS; allows host-based network applications 
programs to exchange information with communications networks. 

Network Access Method/Virtual Environment (NAM/VE) 

The access method that resides under NOS/VE; allows host-based network applications 
programs to exchange information with communications networks. 
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Network Configuration Utility (NETCU) 

A CDCNET utility on NOS/VE that logically configures CDCNET. 

Network Definition 

The process of assigning logical names to network components and assigning values to 
variable parameters for CDCNET software. See also Logical Configuration. 

Network Device Interface (NDI) 

The standard CDCNET device interface variant that transfers data between networks 
(for example, between two local area networks; between a local area network and a 
communications line; or between a local area network and a public data network). 

Network File Manager (NETFM) Utility 

A CDCNET host utility that manages the CDCNET file directory. NETFM allows a 
user to do such activities as creating directory entries for CDCNET files, attaching 
CDCNET files, reviewing the directory, and deleting, updating, and verifying directory 
entries. 

Network File System (NFS) 

A software product of Sun Microsystems, Inc. that allows a variety of machines and 
operating systems to share files. 

Network Identifier 

A unique identifier (32-bit character string) assigned to a network solution. 
Network Invocation Number (NIN) 

A one- through three-digit decimal number that is incremented by one every time 
NAM is brought up. The NIN is used in NOS permanent file names for device 
interface dump files. 

Network Job Entry Facility (NJEF) 

The network applications software that supports IBM's Network Job Entry (NJE) 
protocol on NOS. 

Network Log File 

A file on a host computer that contains CDCNET log messages sent from the network's 
device interfaces and serves as a record of the network's activity. 

Network Log Server (NETLS) 

A CDCNET host application that writes CDCNET log messages generated by device 
interfaces to the network log file on the host. 

Network Logfile Termination (NLTERM) Utility 

A CDCNET host utility on NOS that terminates the currently-active network log file to 
which NETLS is writing log messages, and renames the terminated log file. NLTERM 
also provides information about previously-terminated log files as an aid in managing 
log files. 

Network Operating System (NOS) 

The software that controls data processing and storage in a CYBER 170 mainframe or 
a CYBER 180 mainframe (running NOS only or dual-state). CDCNET files stored and 
processed in CYBER 170 mainframes, such as configuration and boot files, network log 
files, and CDCNET host applications, are run under the Network Operating System. 
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Network Operating System/Virtual Environment (NOS/VE) 

The software that controls data processing and storage in CYBER 180 mainframes. 
CDCNET files stored and processed in CYBER 180 mainframes, such as configuration 
and boot files, network log files, and CDCNET host applications, are run under the 
Network Operating System/Virtual Environment. 

Network Operator 

A person who monitors CDCNET activity, has the ability to control CDCNET hardware 
and software, makes occasional network configuration changes, and performs elementary 
troubleshooting by sending commands to the network's device interfaces. A network 
operator may perform these tasks from a host console or a remote terminal. 

Network Operator Utility (NETOU) 

A group of programs residing on a host computer and in a (NOS) mainframe device 
interface or mainframe terminal interface connected to the mainframe. NETOU allows 
a network operator to access, monitor, control, and configure a CDCNET from the host 
console or a remote terminal. Using NETOU, network operators can send CDCNET 
operations commands to specific device interfaces or to all the device interfaces in the 
network. 

Network Performance Analyzer (NPA) 

The CDCNET software utility that generates statistical reports based on its analysis of 
the network log file or generates event/error reports based on log messages in the 
network log file. 

Network Products Terminal Gateway 

A gateway that allows both interactive and remote batch terminal users to connect to a 
NOS host through CDCNET (by specifying the appropriate service title on the 
CREATE .CONNECTION command). There are two parts to the NP Terminal gateway: 
the Interactive Virtual Terminal gateway (IVT gateway) and the Remote Batch Facility 
gateway (RBF gateway). The batch gateway is dependent on the interactive gateway. If 
a network configuration is going to support terminal connections to NOS, the MDI or 
MTI connected to the NOS host must contain an NP Terminal gateway. 

Network Service Access Point Address (NSAP Address) 

An address used in the OSI protocol stack that uniquely identifies a CDCNET system 
and a user of the OSI Network layer within that system. An NSAP address consists of 
two parts: a Network Entity Title and an NSAP selector. The Network Entity Title 
uniquely identifies a CDCNET system. The NSAP selector uniquely identifies a user of 
the OSI Network layer in that system. 

Network Solution 

A communications medium over which data is transmitted between interconnected 
network resources, and which uses CDCNET protocols. In OSI terminology, a network 
solution is also referred to as a subnet. A network solution differs from other 
communications lines because it is shared by multiple network resources (it is not 
solely dedicated to the handling of data transmissions between a single pair of network 
resources). Network solutions differ from trunks because they can carry network 
management traffic such as log and alarm messages. 
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Network Transfer Facility (NTF) 

An application providing a fully symmetric queue file transport facility between a 
NOS/VE host and another host in a geographically dispersed network. NTF supports 
IBM's Network Job Entry (NJE) protocol and HASP multileaving protocol for 
communication between hosts. 

NFS 

Refer to Network File System. 

NIN 

Refer to Network Invocation Number. 

NJEF 

Refer to Network Job Entry Facility. 

NLTERM 

Refer to Network Logfile Termination Utility (NLTERM). 

NOS 

Refer to Network Operating System. 

NOS/VE 

Refer to Network Operating System/Virtual Environment. 

NPA 

Refer to Network Performance Analyzer. 

NSAP Address 

Refer to Network Service Access Point Address. 

NVT 

Refer to TELNET Network Virtual Terminal. 

o 

Onboard 

ROM-resident; for example, the self-test diagnostics in the device interface. 

Online 

Condition in which a network hardware or software component is present and active 
within the network configuration. 

Online Diagnostics 

Optional diagnostics for the device interface that can be executed while the device 
interface is connected to and operating as part of the CDCNET. 

Online Loader 

A CDCNET service that loads software into device interfaces when the software is 
needed while the network is operational, as opposed to initial loader, which loads 
software into device interfaces only when they are started up (initialized). 
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Open System Interconnection (OSI) 

The International Standards Organization's (ISO's) reference model for network 
processing. This model is based on a network architecture that segregates network 
functions into seven layers. 

OSI 

Refer to Open System Interconnection. 



Passthrough 

Refer to Terminal Passthrough. 

PDN 

Refer to Public Data Network. 

PDU 

Refer to Protocol Data Unit. 

Physical Name 

A name assigned to a hardware device in a device interface: boards, ports, and memory 
banks, such as $CIM3 (physical name for CIM board in slot 3) and $LIM5_PORT2 
(physical name for second port on LIM board in slot 5.) 

Physical Record Unit (PRU) 

The amount of information transmitted by a single physical operation of a specified 
device. For mass storage files, a PRU is 64 central memory words (640 characters); for 
magnetic tape files, the size of the PRU depends upon the tape format. A PRU that is 
not full of user data is called a short PRU; a PRU that has a level terminator but no 
user data is called a zero-length PRU. 

PMM 

Refer to Private Memory Module. 

Port 

The physical connection on the device interface through which data is transferred 
to/from the device interface. Each port is numbered and supports a single 
communication line. 

Primary MDI 

The Mainframe Device Interface (MDI) to which the operator sends commands and 
receives responses and alarms. At any time, only one MDI can communicate with the 
operator. 

Printer Support Utility (PSU) 

The network applications software that supports standalone CDCNET printers on NOS. 
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Private Memory Module (PMM) 

An optional device interface board with 128K bytes of static RAM dedicated to the 
main processor board (MPB) for code execution. 

The logic board within a CDCNET device interface that provides additional random 
access memory dedicated for use by the main processor board (MPB) of the device 
interface. 

Programming System Report (PSR) 

An official report to Control Data of a problem with Control Data software. A PSR can 
be sent to Control Data either in hard-copy form, or by using the on-line SOLVER 
program. 

Protocol 

A set of conventions that must be followed to achieve complete communications 
between the computer-related resources in a network. A protocol can reflect the 
following: 

1. A set of pre-defined coding sequences, such as the control byte envelopes added to 
(or removed from) data exchanged with a terminal. 

2. A set of data addressing and division methods, such as the block mechanism used 
between a network application program and Network Access Method. 

3. A set of procedures that control communications, such as the supervisory message 
sequences used between a network application program and Network Access Method. 

Protocol Data Unit (PDU) 

A data unit that is used to communicate information between peer entities. 

Protocol Stack 

A collection of protocols in successive layers. CDCNET is based on ISO's Open System 
Interconnection (OSI) reference model, where each system includes a set of layers and 
each layer supports one or more protocols. 

CDCNET phase 2 of OSI support includes support for OSI and TCP/IP protocols for 
layers 3 and 4. Therefore, CDCNET supports two protocol stacks: OSI and TCP/IP. 

PRU 

Refer to Physical Record Unit. 

PSR 

Refer to Programming System Report. 

PSU 

Refer to Printer Support Utility. 

Public Data Network (PDN) 

A commercial packet-switching network that supports the communications interface 
described in CCITT protocol X.25. 
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R 

RBF 

Refer to Remote Batch Facility. 

Real-time Clock 

A time- of- day clock maintained by CDCNET device interfaces. 

Recorder Log Group 

A logging function in which device interfaces that are sources of log messages report 
their log messages to a device interface which works with a host application to record 
the log messages in a network log file. The Independent Log ME controls the log 
recording function. 

Relay 

Process occurring when CDCNET receives a data unit from a directly connected 
network solution and transmits the data unit to another directly connected network 
solution. 

Remote Batch Facility (RBF) 

The network applications software that supports remote batch processing (remote job 
entry) on NOS. 

RS-232-C 

An Electrical and Electronic Industries Association (EIA) standard that describes the 
interface between terminals or other Data Terminal Equipment (DTE) and modems or 
other Data Communications Equipment (DCE) employing a serial binary interchange. 

RS-449 

1. A physical interface standard for data communications used with high speeds and 
long communication lines. 

2. A newer standard than RS-232-C, also used for serial, communications. Eventually 
meant to replace RS-232-C, but backward compatibility is specified in RS-449. 



SAP 

Refer to Service Access Point. 

SAP Identifier 

A 16-bit number that uniquely identifies a SAP for other software components. 

SCL 

Refer to System Command Language. 

SCT 

Refer to System Configuration Table. 

SDLC 

Refer to Synchronous Data Link Control. 
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Segment 

The unit of data exchanged by TCP modules. This term also describes the unit of 
exchange between any transport protocol modules. 

Service 

An entity that is external to CDCNET but is registered within CDCNET as being 
capable of conducting input and output with a terminal or with another service. 
Services have names. Terminal users connecting to a host are connecting to a service. 
An example of a service is the Interactive Facility (IAF) on a host. 

Service Access Point (SAP) 

An exchange point between the services of two adjacent Control Data Network 
Architecture (CDNA) layers. 

Single-Bit Error 

A transmission error that affects only one bit in a block of data. Single-bit errors can 
be detected, isolated, and corrected automatically. 

Site Administrator 

A person who configures a site's network, supervises hardware and software changes, 
and ensures that the network operates efficiently. 

SMM 

Refer to System Main Memory. 

SMM4 

A 4 M byte version of the SMM (see System Main Memory). 

SNA 

Refer to Systems Network Architecture. 

SNA3270 TIP 

A terminal interface program that provides IBM 3270 Information Display System 
users access to CDCNET through an SNA network. 

Socket 

A TCP/IP address used to locate a process on a host. This address is used by 
Transmission Control Protocol (TCP) and User Datagram Protocol (UDP). It consists of 
the 32-bit IP address and a 16-bit port number. 

SOLVER 

An online utility maintained by Control Data that contains a database of reported 
software problems and solutions. SOLVER can be used for writing a PSR to report a 
problem with software. 

Source Log Group 

A logging function in which device interfaces that are sources of log messages maintain 
a list of log messages which they will send to recorder device interfaces. The source 
logging function is controlled by the Dependent Log ME, also known as Log Support 
Application (LSA). 
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Stack 

An area in memory used as temporary storage for chaining calls during task or 
interrupt service routine execution. Task calls are chained on a user stack. Interrupt 
service routine calls are chained on a supervisor- stack. 

Stack Frame 

The area within a stack that accommodates a single call. 

Statistics 
Refer to Metrics. 

Status 

Information about the current state of a network component: Device Interface (DI), the 
hardware components (boards, ports) of a device interface, lines and network solutions 
connected to the device interface, and device interface software. 

Status Command 

A command that requests and displays the operational status of a particular network 
component, such as a device interface or a network solution. 

Subnet 

The concept of a subnet is used both in OSI and TCP/IP. Therefore, there are two 
definitions of subnet. 

1. OSI: In CDCNET, individual systems are connected to each other via different 
media such as Ethernet and HDLC. A medium connecting two or more CDCNET 
systems is called a network solution or a subnet. For OSI, a subnet refers to one 
and only one network solution. 

2. TCP/IP: TCP/IP subnetting is a required Internet standard. Subnetting allows a 
configuration consisting of many physical networks to be addressed with a single IP 
network number. Each physical network is assigned a subnet number. Each host is 
addressed based on its network number, subnet number, and host number. These 
three fields make up the IP address. 

Subnet Identifier 

An identifier that identifies a subnet in a CDCNET network. It must be unique, and 
must not be associated with more than one subnet in a CDCNET network. ' 

Switched line 

A communication line connected with one device interface, but able to be connected to 
any one of several terminals via a switching mechanism, such as a dialed telephone 
line. Contrast with Dedicated Line. 

Synchronous Command Entry Mode 

A command control mechanism that prevents operators from entering a command 
before a previously sent command has executed and returned a response. 

Synchronous Data Link Control (SDLC) 

Bit-oriented data link control protocol developed by International Business Machines 
(IBM). 
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System Address 

The unique address assigned to a device interface in the network. The system address 
corresponds to the system title, so that commands and data sent by system title are 
received at the proper device interface address. See also System Identifier. 

System Command Language (SCL) 

The NOS/VE command language on which CDCNET network operations, and 
configuration and terminal user commands are based. 

System Configuration Table (SCT) 

A data table maintained in device interface memory that contains the values of current 
and configurable system variables. 

System Console 

A component of a host operating system that is used to monitor and control the 
operating system. The system console can also be used to monitor and control CDCNET 
through the Network Operator Utility (NETOU). See also Host Console. 

System Identifier 

At the time of its manufacture, each device interface is assigned a unique 48-bit 
identification number from a pool of numbers allocated to Control Data by Xerox This 
number is written into battery-backed RAM and is used throughout the catenet as the 
system identifier for that device interface. 

The system identifier is used as the Ethernet address for any system that is locally 
connected to one or more Ethernet network solutions. 
See also System Address. 

System Main Memory (SMM) 

A device interface board containing dynamic RAM accessible by all interfaces and the 
resident main processor board (MPB). 

System Title 

The title assigned to a device interface during logical configuration. This title 
corresponds to the device interface's system address, so that commands sent to a device 
interface by system are received at the proper device interface address. 

Systems Network Architecture (SNA) 

IBM standard defining the layers and layer protocols to be used within an IBM 
network. 

SYSTEMX 

A NOS user name that is used to store files for NOS and CDCNET installation and 
operations. 



T-to-A 

Refer to Terminal-to-Application. 

TAM 

Refer to Total Allocatable Memory. 
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Task Control Block (TCB) 

The task control block is a data structure that maintains the context of a task while it 
is executing. 

TCB 

Refer to Task Control Block. 

TCP 

Refer to Transmission Control Protocol. 

TCP/IP 

Refer to Transmission Control Protocol/Internet Protocol. 

TDI 

Refer to Terminal Device Interface. 

TDP 

Refer to Terminal Definition Procedure. 

TELNET Network Virtual Terminal (NVT) 

A TCP/IP protocol that provides presentation layer services for other application 
protocols. TELNET NVT protocol is roughly equivalent to VTP in the ISO model. It 
establishes connections and controls interactive virtual circuits. 

Terminal Definition Procedure (TDP) 

An optional configuration file that defines a terminal device or devices connected to a 
line whenever the line becomes active. A TDP can be used to define a terminal device 
that differs from the default terminal device type defined by the TIP that controls the 
line. 

Terminal Device Interface (TDI) 

The CDCNET device interface variant that interconnects terminals, workstations, and 
unit record devices with an Ethernet local area network. 

Terminal Interface Program (TIP) 

CDCNET software that resides in terminal device interfaces (TDIs) and enables 
terminals/workstations that employ specific terminal protocols (such as async, HASP, 
and IBM 3270) to communicate in CDCNET networks. 

Terminal Passthrough 

A CDCNET feature that allows interactive asynchronous terminal traffic to pass 
through the network transparently. The hosts and terminals interface with each other 
as if they were directly connected. Terminal passthrough allows a CDCNET-connected 
terminal user to access non-CDCNET supported hosts, such as NOS/BE and VAX. 

Terminal-to-Application (T-to-A) 

A type of network processing that enables the exchange of data between applications 
programs that reside on host computers and user terminals or workstations. In this 
case, protocol conversions occur so that transmitted data is understood both at the host 
and at the terminal or workstation. 
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Terminal User Procedure (TUP) 

An optional configuration file that defines attributes of terminals and connections. A 
TUP can be used to define attributes for a particular terminal model or a group of 
terminals. A TUP for a terminal is executed when the communication line from the 
terminal to the supporting device interface becomes active. 

Test 

Software and/or microcode that provides detection and confidence capabilities. Also 
known as a diagnostic. 

Text 

A sequence of characters forming part of a transmission that is sent from a source to a 
receiver, containing the information to be conveyed. 

TIP 

Refer to Terminal Interface Program. 

TIP Interface Record Table (TIRT) 

A TDI data structure that maintains information about active TIPs. 

TIRT 

Refer to TIP Interface Record Table. 

Title 

A string of 1 through 255 ASCII characters that identify a network service component 
such as a device interface or a gateway. The Directory Management Entity refers to 
the component by its title. 

A name used to identify services available in the network. Titles are known throughout 
the catenet. Contrast with Logical Names, which are local to individual device 
interfaces. 

Total Allocatable Memory (TAM) 

The amount of memory at the end of configuration that is available for dynamic 
memory or buffer allocation. This excludes the memory used by active tasks. 

Transmission Control Protocol/Internet Protocol (TCP/IP) 

The name given to a suite of protocols that support the ARPANET community. TCP/IP 
protocol implementation is required within CDCNET for connectability to Defense Data 
Networks (MILNET or ARPANET) and to workstations that use TCP/IP. 

Transmission Control Protocol (TCP) 

A term used in DDN networks that refers to an end-to-end, connection- oriented 
protocol corresponding to the CDCNET Transport layer. This protocol is required for 
connection to MILNET, ARPANET, and TCP/IP workstations. 

Transport Layer 

Open Systems Interconnection (OSI) layer 4. Provides end-to- end control of a 
communication session once the path has been established. It allows processes to 
exchange data reliably and sequentially, regardless of which systems are 
communicating. 
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Trunk 

A logical definition of a line and the communications software that allows the line to 
carry data between communications controllers. These controllers could be device 
interfaces or devices for other networks. Trunks going to other networks, such as 
DECNET or SNA, are not recognized as network solutions. 

TUP 

Refer to Terminal User Procedure. 

u 

ULP 

Refer to Upper Layer Protocols. 

Unit Record Interface (URI) 

A Line Interface Module (UM)-type peripheral circuit board that interfaces with the 
LIM bus and is used with the Communications Interface Module (CIM). The URI 
provides an 8-bit parallel interface for the operation of character or line printer. The 
URI includes all necessary drivers, receivers, timing, and control circuitry to drive one 
printer at a time. 

Upper Layer Protocols (ULP) 

A collective term for layers 5, 6, and 7 of the Open System Interconnection (OSI) 
network reference model. 

URI 

Refer to Unit Record Interface. 

User TELNET 

Allows a CDCNET terminal to connect to a foreign host's interactive service using 
TCP/IP TELNET communications. 



VE Interface 

A channel between a NOS/VE host and an MDI or ICA-II that uses the OSI protocol 
stack. 

Version 

A four-digit hexadecimal number indicating the release version of the software loaded 
in a device interface. 

Virtual Circuit 

A connection between a source and a receiver in a network that may be realized by 
different circuit configurations during data transmission. Also called a logical circuit. 



60000414 C Glossary A-27 



Wildcard Characters XJ56 ^^ 



w 

Wildcard Characters 

Characters that can be used in place of other characters as variables. Wildcard 
characters can be used to replace single characters, to replace strings of characters, or 
to match characters to those specified in a list. 



X.25 

The Consultative Committee of International Telephone and Telegraph (CCITT) 
standard for the interface between Data Terminal Equipment (DTE) and Data 
Circuit-Terminating Equipment (DCE) in an X.25 packet-switching network. 

X.25 Asynchronous TIP 

Also known as X.29 PAD, this is a CDCNET feature that allows asynchronous 
terminals to access CDCNET either by a Public Data Network (PDN) that supports the 
X.3 Packet Assembly/Dissassembly (PAD) facility or by the terminals operating in X.25 
mode. 

X.25 Gateway 

A gateway used to transfer data from a host connected to CDCNET to a host in 
another network at the other end of the X.25 circuit. The X.25 gateway allows 
host-to-host (A-to-A) connections to take place over an X.25 circuit. A-to-A connections 
over X.25 circuits are provided by the Network Products applications. 
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NLTERM, NLLIST, and NLPURGE 

Utilities (NOS Only) B 

This appendix contains instructions, command descriptions, and messages generated by 
the following NOS utilities: Network Logfile Termination Utility (NLTERM), Network 
Logfile List Utility (NLLIST), and Network Logfile Purge Utility (NLPURGE). These 
utilities do not run under the Network Operator Utility (NETOU). 
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NLTERM (Network Logfile Termination Utility) 
Terminate CDCNET Log File 

Purpose Invokes NLTERM. Terminates CDCNET network log files, and renames the 
terminated log files. 

Format NLTERM 

OP = keyword value 
NM = file name 
L = file name 

Parameters OP 

Specifies the environment in which NLTERM and its parameters run. This 
parameter is needed only if you want to change the default option for your 
origin type. The following keyword values are allowed. 



Keyword Value 



Description 



K Parameters are entered from host console. 

T Parameters are entered from interactive 

terminal using full screen interface. If the T 
parameter is specified, the L parameter is used. 

Z Specifies that NLTERM is run with no 

interactive interface. In that case, NLTERM 
subcommands are specified only with the 
NLTERM command itself. In Z mode, you can 
only terminate the log file. You cannot perform 
other NLTERM activities, such as routing and 
purging files. 

If you enter NLTERM at a host console, default is K. At an interactive 
terminal, default is T. For batch jobs, default is Z. Entering only NLTERM 
at a terminal enters you into a full screen NLTERM session. 

If you want to use the interactive terminal interface, which uses screen 
formatting, make sure that your terminal is in screen mode rather than 
line mode. When you enter just NLTERM from a terminal without 
specifying the T parameter, you receive the following message if the 
terminal is in line mode: 

NLTERM - LINE MODE IS NOT SUPPORTED, USE SCREEN 

If you do not have screen mode at your terminal, you have to enter all the 
parameters with the NLTERM command using the Z option. If you have 
type-ahead defined for your terminal, the cursor goes on to the next line or 
start over at the same line when you come to the end of a field. 
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NM 

Specifies the name of a NOS permanent file that receives the contents of 
the terminated network log file. Names may be from 1 to 5 alphanumeric 
characters long. NLTERM always attaches the prefix NL to file names. For 
example, the name LOG3 is named NLLOG3 by NLTERM. 

If this parameter is not specified, a default file name is generated by 
NLTERM in the format 

NLxmmdd 
where: 

x The sequence number of the file. There are 36 possible values for 

x: A through Z, followed by through 9 (see note). 

mmdd The month and day on which the network log file was 
terminated. 

NOTE 

NLTERM creates default file names, up to a limit of 36 file names per 
day. If more than 36 files are terminated in one day, you must supply a 
specific file name. NLTERM batch jobs attempting to terminate more than 
36 files do not terminate the file, and abort after sending an error 
message. 



Specifies the name of the file to receive the list of terminated network log 
files. Parameters are used as initial values in both displays. L is a local 
file. This parameter is only meaningful if the NLTERM command list is 
entered through the host console or interactive terminal interface. The 
default file name is LIST. 

Remarks You can change the values of the NM and L parameters during an 

NLTERM session, if you want to change the name of the permanent file to 
receive a terminated log file, or the name of the local file to receive the 
listing of terminated log files. 

Examples nlterm,op=t ,nm=f i le1 . 
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NLLIST (Network Log File List Utility) 
List Terminated CDCNET Log Files 



Purpose 



Format 



Remarks 



Examples 



Lists previously terminated network log files. The LIST subcommand in the 
NLTERM interactive or K display interface performs the same function as 
NLLIST. 



NLLIST 

L = file name 



Parameters L 



Name of file to receive listing of previously terminated network log files. 
Specified as a local file name. Default depends on environment in which 
NLLIST was entered. The default file name is LIST, unless NLLIST is 
submitted as a batch job (default is OUTPUT). After the NLLIST command 
executes, use the NOS command ROUTE to route the local file to a printer 
or you can copy the local file to your screen using the COPY command or 
NOS Full Screen Editor. 

The LIST subcommand in the NLTERM interface performs the same 
function as NLLIST. See the instructions for using NLTERM. 

NLTERM has several subcommands. 

Command Desc ription 

^ _____ _ 



LIST 

PURGE 

OUT 

CLEAR 

STOP 
TERM 



Terminates the currently active log file using the current 
network log file name parameter value. If this command 
fails after the name is changed, then the TERM command 
can be used (see TERM description). 

Generates a list of previously terminated network log files. 
The list is then displayed on the screen and written to a 
file specified by the L (LIST) on the NLTERM command. 
Performs the same function as the NLLIST command. 

Purges the terminated network log file that is specified by 
the network log file name (NM) parameter value. 

Routes the file specified by the L (LIST) parameter to the 
printer. 

Returns the NLTERM command list to the screen, replacing 
the display of the list of terminated log files generated by 
the LIST command. 

Terminates NLTERM processing normally. 

Recovers a network log file if an error occurs while the log 
file is being terminated. 



This example sends the list of terminated log files to a file called 
LOGFIL2. 

nlllst,l«logfll2. 
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NLPURGE (Network Logfile Purge Utility) 
Purge Terminated CDCNET Log Files 

Purpose Purges previously terminated network log files. The PURGE subcommand 
in the NLTERM interactive or K display interface performs the same 
function as NLPURGE. 

Format NLPURGE 

NM = file name 

Parameters NM 

Name of the terminated log file to purge (see format specified for the NM 
parameter used with NLTERM). 

Remarks The PURGE command in the NLTERM interface performs the same 
function as NLPURGE >. 

Examples This example purges the terminated log file NLA0101. 

n 1 purge, nm=nla0 101 
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CDCNET File and Procedure Management 
Utilities (NOS Only) C 

This appendix describes the following CDCNET NOS utilities: Network File Manager 
(NETFM) and related utilities (NETBDF, NETMDF, and NETRDF), and Network 
Procedure Library Manager (NETPLM). Messages generated by these utilities are 
documented in the NOS Operations handbook and the NOS Reference Set, Volume 3. 

Network File Manager Utility (NETFM) Overview 

Network File Manager (NETFM) is a NOS utility that manages CDCNET host files 
and maintains the CDCNET directory. This directory correlates CDCNET file names 
with their NOS permanent file names. When CDCNET configuration files are created 
and edited, you use NETFM to create or update their directory entries. 

The CDCNET directory is a private, direct-access permanent file, named NETDIR. 
NETDIR has entries for all CDCNET files on the NOS host. It is the only link 
between NOS file names and CDCNET file names. When DIs are initialized, NETDIR 
determines NOS file names for CDCNET configuration files (exception list, boot files, 
all system configuration procedures, terminal definition procedures (TDPs), terminal 
user procedures (TUPs), and load procedures (LPs)). NETFM attaches and purges these 
CDCNET files, and creates, deletes, lists, updates, and verifies directory entries. 

To create directory entries for files, NETFM executes the NOS commands CATLIST 
and ATTACH (in read mode) on files. In addition, NETFM can be used only from user 
names permitted to access NETDIR. Typically, NETFM executes from the user name in 
which the file is stored, so no special effort is needed to access NETDIR, or to allow 
NETFM to execute ATTACH and CATLIST. However, if a file is under an alternative 
user name, you must allow ATTACH and CATLIST on the file and make it available to 
the user name on which NETFM executes. To allow CATLIST on the file by NETOPS, 
NETADMN, or another user name, specify AC=Y on the DEFINE, SAVE, REPLACE, 
or CHANGE command for the file. To allow user names to access NETDIR, and to 
specify read access for files, use the PERMIT command. 

PERMIT,filename,username=mode (READ) 

NOTE 

When adding directory entries with NETFM, the NETFM job must execute under a 
user name. Otherwise, added entries are invalid (because there is no user name in the 
user name field in the directory entry), causing file access attempts to fail. A 
no-user-name situation can occur when running NETFM at the system console, and 
when X.DIS and SUI are specified to access an account. To remedy this situation, use 
a user name statement instead of SUI to access the account where NETFM runs. This 
recommendation also applies to NETMDF. 

Frequently accessed CDCNET files, such as TDPs and TUPs, should have the retain 
flag (RT=Y) set in their directory entries (see RT description in the CREATE directive 
in this appendix). This causes Network File Server (NETFS) to keep an accessed file 
local during a retain timer period. If the file is accessed again during that period, 
NETFS does not have to reattach the file, saving time and file use. 
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NETFM Directives Summary 

Use the directives described in table C-l to maintain the CDCNET directory and to 
access CDCNET files. More detailed descriptions of the directives are provided later in 
this appendix. 

Table C-L NETFM Directives Summary 

Directive Description 



ATTACH Gets/attaches a permanent file based on information in the directory. 

CREATE Creates an entry in the CDCNET directory. 

DELETE Deletes an entry in the CDCNET directory. Does not purge the 

permanent file associated with the directory entry. 

LIST Lists a CDCNET directory entry. You may list a single entry or all 

entries in the directory. 

PURGE Purges a NOS permanent file and deletes the file's directory entry. 

UPDATE Updates the CDCNET directory to match the NOS permanent file base. 

VERIFY Verifies that the CDCNET directory entry matches the characteristics 
of the actual file. 



Three procedures help you use NETFM directives: ATTCF (Attach Configuration File), 
DEFCF (Define Configuration File), and REPCF (Replace Configuration File). These 
procedures execute FCOPY and NETFM directives for NOS CDCNET configuration 
files. 

When executing CREATE, UPDATE, and VERIFY, NETFM internally gets/attaches 
permanent files specified in the PF (permanent file) parameter using local file 
ZZZZZFM. To prevent file-busy errors, return all direct access files in write mode to be 
accessed by CREATE, UPDATE, and VERIFY before accessing NETFM. 

Using NETFM 

1. Make sure the directory is already built. It should have been built during 
installation. If it is not, or if a new directory must be built, use NETBDF, 
described later in this appendix. 

2. To run NETFM interactively, log in to IAF on a user name validated to access 
NETDIR. 

3. Enter the following: 

NETFM,I = input file,L=list file.UN 

All parameters are optional. However, to use the official NETDIR on NETOPS, you 
must specify UN as a keyword. See the parameter descriptions in the NETFM 
command description later in this appendix. 

4. Enter NETFM directives. See instructions for entering NETFM directives later in 
this appendix. 
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NETFM Command 

Purpose Accesses Network File Manager (NETFM), which allows you to access the 
CDCNET directory, using NETFM directives. You use NETFM any time 
you create, attach, or purge files used by CDCNET. You also use NETFM 
to attach, create, delete, list, purge, update, and verify CDCNET directory 
entries. 

Format NETFM 

abort option 
I = input file 
L=list file 
UN = user name 
z option 

Parameters abort option 

Abort option, specified by the keyword ABORT. If specified, the abort 
option causes NETFM to abort on nonfatal errors and not execute any 
further directives. 

I = input file 

The input file in which NETFM directives are located. You can specify this 
parameter using one of the following options: 



Value 



Description 



I 
I=lfn 1 

1=0 



I (omitted) 



Directives are on file INPUT. 

Directives are on local file lfnl (file name of your 
choice). 

No input directive file. If this option is chosen, the z 
option must be specified in the NETFM command and 
in directives following the NETFM command 
terminator. 

Directives are on file INPUT or, if z option is 
specified, after the NETFM command. 



L=list file 

The output file in which NETFM list output is to be written. You can 
specify this parameter using one of the following options: 



Value 



Description 



L=lfn2 

L=0 

L (omitted) 

L 



List output in local file lfn2 (filename of your choice). 

No list output. 

List output on local file OUTPUT. 

List output on local file OUTPUT. 
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UN = user name 



The user name from which the directory should be attached. You can 
specify this parameter using one of the following options: 

Value Description 



UN Attach the directory from user name NETOPS. 

UN = user _ Attach the directory from the user name specified, 

name 

UN (omitted) Attach the directory from the user name where NETFM 
is executing. 

z option 

Specifies whether or not the NETFM command contains input directives 
(such as ATTACH, CREATE, and UPDATE). If Z is present, the input 
directive is taken from the command following the terminator of the 
NETFM call. If Z is omitted, the NETFM command does not contain input 
directives. 

If Z is present and directives are present, the NETFM command has the 
following format: 

NETFM,UN,Z./input 1 /input 2 /.. .input n 

input Specifies one line of NETFM directive input. 

/ Separates input lines. This character must immediately 

follow the right parenthesis or period. 

The total input line including the NETFM command, parameters, and 
directives, cannot exceed 80 characters, and continuation lines are not 
allowed. Continuation lines are allowed if NETFM directives are in a 
directive file (see Continuing NETFM Directive Entry on Another Line 
later in this appendix). 

The following example specifies two LIST directives following the Z 
parameter on the NETFM command. The LIST directives list a directory 
entry for a CDCNET object library file with CDCNET file name 
MODULE#0102, and also lists all version 0102 boot files. 

NETFM(Z)/LIST,LO=F,NF=MODULE#0102*/L,NF=BOOT#0102 
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Using NETFM Directives 

This section contains instructions on using NETFM directives. 

NETFM Directive Input Requirements 

Interactive directives are always processed as 6-bit (normal), because NETFM has an 
embedded CSET (NORMAL) that overrides the terminal's current character mode. The 
initial character mode is restored when NETFM terminates. 

CAUTION 

Do not enter a user break sequence while a NETFM directive is executing. Interruption 
of directive processing may cause errors in the directory, which later cause NETFM to 
malfunction. You can partially recover the directory using NETMDF and NETRDF (see 
descriptions later in this appendix). 

The following example deletes the directory entry for a CDCNET configuration file. 
Either the CDCNET file name or the NOS permanent file name may be specified with 
the directive. This example specifies the NOS permanent file name, CF0072. The 
directive response is also shown. 

If PF is the only parameter specified, you must execute NETFM from the user name 
under which the file is stored. In this example, NETFM was executed from user name 
NETSUPP. 



DELETE, PF-CF0072 








Response: 








NETWORK FILE NAME 


PFN 
FS 

COMMENT 


TYPE DN UN PN CREATION 
RT DATE/TIME 


LAST MOD 
DATE/TIME 


DELETED CONFIGURATIONS 
80025100072 


CF0072 
1 


IND NETSUPP 85/07/10. 
F 15.36.49. 


85/07/10 
15.36.49 
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The fields in a NETFM directive response are described below. 
Field Description 



response 

NFN 
PFN 
TYPE 
DN 



UN 

PN 

CREATION 
DATE/TIME 



LAST MOD 
DATE/TIME 



FS 
RT 



COMMENT 



Indicates action taken after the NETFM directive was entered. In 
the example, DELETED is the response. 

CDCNET file name. This name spans multiple lines, if necessary. 

NOS permanent file name. 

File type, either direct (DIR) or indirect (IND) access. 

Device type of the auxiliary pack or device number of the family 
device on which file is stored. The device number may be from 1 
through 77. Allowed device types are described in the NOS 2 
Reference Set, Volume 3, in the section on permanent file 
commands. 

User name of the owner of the NOS permanent file. 

Pack name. The auxiliary device where the file is stored. 

Date and time file was created. This information is not actually in 
the directory entry; it is obtained from a CATLIST of the file and 
combined with directory information. 

Date and time file was last modified. This information is not 
actually in the directory entry; it is obtained from a CATLIST of 
the file and combined with directory information. 

File size, in decimal PRUs. 

Value of retain flag. Used only for files accessed by Network File 
Server (NETFS), which interfaces the CDCNET file access system 
with the NOS file access system. There are two possible values for 
RT: 

F Retain flag not set (default value) 

T Retain flag set 

Brief description of the file or other comment (see Entering 
Comments in a Directory Entry, later in this appendix). 
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Specifying Directives on the NETFM Command 

You may enter NETFM directives with the NETFM command itself, all on the same 
line, by using the Z option (see NETFM command format). A delimiter seperates 
multiple commands. If you specify NETFM directives following the NETFM command 
using the Z option, and if you execute NETFM as an interactive command, directives 
do not have to be in display code. 

Example: 

This example specifies two directives at the end of the NETFM command: DELETE (D) 
and LIST (L). When this command executes, first NETFM is accessed, then the 
CDCNET directory entry for NOS permanent file name CF0072 is deleted, and then all 
configuration procedures are listed (L,NF=CONF*). The slash character (/) separates 
the directives. The * at the end of the list directive is a wildcard character. See 
Wildcard Characters, described next, for more information. 

NETFM(UN,Z)/D,PF=CF0072/L,NF=CONF* 

Wildcard Characters 

Wildcard characters provide flexibility when searching for CDCNET file names. You 
can use wildcard characters in file names on NETFM directives, rather than entering 
all file names matching the file name modified by wildcard characters. For example, 
wildcard characters specified in a file name on a LIST directive results in a listing of 
several directory entries for several files. Or, you can verify CDCNET directory entries 
for several files using one VERIFY directive and a CDCNET file name with wildcard 
characters. 

The wildcard characters, described in table C-2, can be used with all NETFM directives 
except ATTACH and CREATE. 
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Table C-2. Wildcard Characters 



Wildcard Character Description and Use 



[X..X] 



t A X..X] 



Replaces any single character in a CDCNET file name 
except the underscore (_) or pound-sign (#) characters. In a 
search for CDCNET file names matching the name modified 
with the wildcard characters, the question mark matches 
any character except _ or # that appears where a question 
mark is part of the wildcard name. 

For example, MODULE#09?? matches all CDCNET file 
names beginning with MODULE#09 and ending with any 
two characters. 

Represents any string of characters in a CDCNET file name. 
If the asterisk is the last character in the file name, it 
means the rest of the file name being compared to the 
wildcard character matches. 

For example, DUMP#FULL_* matches all CDCNET file 
names beginning with DUMP#FULL_. The asterisk 
wildcard character is useful when searching the directory for 
dump files or other groups of files. 

If the asterisk is not the last character, it matches zero or 
more characters up to the underscore or pound-sign 
character. 

For example, DUMP#*_*A2_* matches all dump files for a 
DI with a system ID ending in A2. 

If the asterisk is in the middle of a file name component or 
level (at neither the beginning nor the end of a name level), 
that level name must match the characters immediately 
preceding and following the asterisk. The asterisk matches 
zero or more characters. 

No wildcard characters can immediately follow an asterisk. 

Matches a single character from the set in brackets. For 
example, BOOT#060[0..5]* matches any CDCNET boot file 
having a version level beginning with 060 and ending with 
any value from through 5. 

Matches a single character that is not from the set in 
brackets. 
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Examples: 

The following LIST directive lists all entries where the first three letters of the 
CDCNET file name are CON. Full directory entries are to be listed; this is specified 
by the LO parameter. 

LIST NF=CON*. LO=F 

Output for the LIST directive is as follows: 



CONFIGURATIONS CF0081 INO NETADMN 

80025100081 8 F 

CONFIGURATIONS CF00A2 IND NETADMN 

800253000A2 8 F 

CONFIGURATIONS CF00C0 IND NETADMN 

800253000CO 3 F 

CONFIGURATIONS CFOOBE IND NETADMN 

800253000BE 3 F 



85/10/28. 85/10/29. 
21.03.49. 07.01.48. 

85/10/28. 85/10/29. 

21.03.53. 07.00.43. 

85/10/28. 85/10/29. 

21.03.54. 06.57.48. 

85/10/28. 85/10/29. 
21.03.53. 06.57.42. 



The following example uses the ? wildcard character to search for all CDCNET file 
names beginning with MODULE#0. 

LIST NF=MODULES??? 

Output: 

MODULES606 
MODULES607 

The following example uses the * wildcard character to search for all files beginning 
with BO (boot files). 

LIST NF=BO* 

Output: 

BOOTS606_ESCI 

BOOTS607_MCI 

The following example uses the * wildcard character to search for all dump files listed 
in the directory. 

LIST NF-DUMP#FULL» 

Output: 

DUMP#FULL_080025 1 00080.850 1 108 1 925 

DUMP#FULL_080025 100080.850 1 1 082538 

DUMP#FULL_080025 1 00080.850 1 1 0824 1 
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Continuing NETFM Directive Entry on Another Line 

To continue a NETFM directive on another line, use the ellipsis (..) at the end of a 
line you have entered. 

Example: 

This example creates a directory entry for configuration procedure 
CONFIGURATION#080025100072 in the catalog of user name NETSUPP. 

CREATE , PF-CF0072 , UN=NETSUPP , NF=CONFIGURATION#080025 1 00072 

Entering Comments in a Directory Entry 

You may use comments in a CDCNET directory entry to explain the file's contents. 
Both CREATE and UPDATE allow you to enter comments in the directory entry. For 
both directives, specify comments using the C parameter. Enter comments as a string 
value enclosed by quotation marks ("). If the comment itself contains quotation marks, 
the comment entry must have two consecutive quotation mark characters to indicate 
the quotation mark within the comment. 

Example: 

The following CREATE directive creates a new directory entry for a boot file. The 
entry contains a comment about the file. The comment itself contains quotation marks, 
so two consecutive quotation marks must be used in the comment string. 

CREATE, PF=BT24DTE,NF=B0OT#0 10 1_ESCI.UN=USERAA, . . 
C="TEST BOOT FILE FOR ""WEEK 1 TESTING"" PROGRAM" 
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ATTACH (A) 

Purpose Attaches or gets a permanent file. You must be validated to access the 
permanent file with the requested access mode. 

Format ATTACH 

LF= local file 
PF= permanent file 
NF= network file 
UN = user name 
PN=pack name 
PW=password 
M=mode 

Parameters LF = local file 

Local file name used to reference the file. 

PF = permanent file 

The permanent file to attach. You do not also have to enter the network 
file name in order for ATTACH to execute. Either PF or NF is required. If 
PF and NF are specified, PF is ignored. 

NF= network file 

The CDCNET file name for the file. Either PF or NF is required. If NF 
and PF are specified, PF is ignored. For faster processing, use NF instead 
of PF whenever possible. Wildcard characters are not allowed on CDCNET 
file names on ATTACH. 

UN = user name 

User name under which the file is stored. If UN is specified, NETFM 
attempts to attach the file using a file entry matching the NF or PF and 
UN parameters specified. If you omit UN, the user name listed in the 
directory entry is used when NF is specified, and the current job's user 
name is used if PF alone (no NF parameter) is specified. 

PN=pack name 

Auxiliary device name. If PN is specified, the permanent file on the 
specified auxiliary pack is attached. The pack name must match the pack 
name stored in the directory entry. If PN = 0, the permanent file residing 
on the system default family is attached. Default for PN is to ignore the 
pack name when searching the directory. 



PW= password 

Password required for attaching the permanent file. 
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M=mode 



Access mode in which the permanent file is attached. The following access 
modes are allowed: 

Value Description 



R Read mode 

W Write mode 

Default is R (read mode). This parameter has meaning only if the 
permanent file attached is a direct access file. For more information on file 
access modes, see the section on permanent file commands in the NOS 
Reference Set, Volume 3. 

Examples This example attaches CDCNET file CONFIGURATION#080025100071 and 
writes it to local file CONFILE. 

ATTACH, NF=CONFIGURATION#OB0025 10007 1 , LF=CONFILE 

PERMANENT FILE ATTACHED. 

This example attaches the DI dump file with NOS permanent file name 
DSAS323 and writes it to local file XXI. 

A . PF=DSAS323 , UN=NETOPS , LF=XX1 
PERMANENT FILE ATTACHED. 
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CREATE (C) 

Purpose Creates an entry in the CDCNET directory file, NETDIR. The NOS 

permanent file corresponding to the CDCNET directory entry must already 
exist. When executing CREATE for a file not stored under the user name 
where you are executing NETFM, you must be able to do CATLIST and 
ATTACH on the permanent file to create a directory entry. See the section 
on permanent file commands in the NOS Reference Set, Volume 3, for 
restrictions on CATLIST and ATTACH. 

Format CREATE 

PF= permanent file 
NF= network file 
UN = user name 
PN=pack name 
R= device type 
C= comment 
RT=retain timer 

Parameters PF = permanent file 

The permanent file name to be stored in the directory entry. If PF is the 
only parameter specified, you must execute NETFM from the user name 
under which the file is stored. 

The file should be able to have a CATLIST performed on it by NETOPS, 
NETADMN, or any other user name under which you perform network 
administration activities. Specify these conditions by the parameter AC=Y 
on the NOS DEFINE, SAVE, REPLACE, or CHANGE command. If the file 
is private, it must have read permission permitted to NETOPS, 
NETADMN, or any other user name on which you perform network 
administration activities. Specify read permission using the PERMIT 
command. 

PERMIT,filename,username=mode (READ) 

NF= network file 

The CDCNET file name to be stored in the directory entry. Wildcard 
characters are not allowed on CDCNET file names on CREATE. 

UN = user name 

User name under which the file is stored. If UN is specified, NETFM uses 
this user name when creating the directory entry. If UN is not specified, 
your current user name is used in the directory entry. 

PN=pack name 

Auxiliary device name to be stored in the directory entry. The permanent 
file is assumed to be on this pack. If PN is not specified or is zero, the 
default is the system default family. 
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R= device type 

Device type (DT) identifier to be stored in the directory entry. Values 
allowed for this parameter are specified in Volume 3 of the NOS Reference 
Set, in the section on permanent file commands. The default for this 
parameter is the system default device. 

C= comment 

Comment text to be stored in the directory entry. Comments are specified 
as a string surrounded by quotation marks ("). Comment strings can range 
from 1 through 50 display code characters. Additional characters are 
truncated. If the string contains a quotation mark, two consecutive 
quotation marks must be used to designate a quotation mark in the 
comment text. 

RT=retain timer 

Value for the retain flag in the directory entry, which determines the 
directory access and NOS permanent file attachment process. This 
parameter is not normally needed for CREATE directives; it is meaningful 
only for files accessed by Network File Server (NETFS). Allowed keyword 
values are the following: 

Value Description 



Y Set the retain flag. 

N Do not set the retain flag. 

Default is N. 

If RT=Y, directory access and attachment of files are performed by 
NETFS only the first time inactive files are opened. Files remain attached 
by NETFS until one of the following conditions occurs: 

• The network shuts down. 

• NETFS terminates abnormally. 

• The NETFS retain timer for a file expires. 

If RT=N, NETFS accesses the directory and attaches a permanent file 
each time it receives a request to open a file while a file is inactive. To 
reduce performance overhead and central memory requirements, specify 
RT=Y for files NETFS frequently accesses, such as library files. RT=Y 
should be set for all files of type MODULE*. 

The following table shows file types supported by NETFS, with the fixed 
portion of the CDCNET file name in parentheses for each file type, and 
the default retain timer values for each file type. A retain timer 
determines how long, after the most recent file access, NETFS retains a 
file before returning the file to the operating system. 
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CREATE (C) 



Default Retain Timer 



Dump seconds 

Boot 5 seconds 

Module library 180 seconds 

Exception list 5 seconds 

Configuration procedure (individual file) 5 seconds 

Configuration procedure (library) 30 seconds 

Load procedure (individual file) 30 seconds 

Load procedure (library) 30 seconds 

Terminal definition procedure (individual file) 30 seconds 

Terminal definition procedure (library) 30 seconds 

Terminal user procedure (individual file) 30 seconds 

Terminal user procedure (library) 30 seconds 

All others seconds 

NOTE 

These default retain timer values can be changed by reinstalling the CHA 
(CDCNET Host Applications) product on NOS. See the NOS Installation 
handbook for details on CHA installation. 

Remarks When executing CREATE, NETFM internally gets or attaches the 

permanent files specified by the PF parameter (using local file ZZZZZFM). 
To prevent file-busy errors, return all direct access files in write mode to 
be accessed by CREATE before accessing NETFM. 

Examples The following examples are performed from user name NETADMN. 

This example creates a new directory entry for CDCNET boot file 
BOOT#0535_ESCI. The boot file's NOS permanent file name is BTD0535. 
The file is stored under NETADMN with read permission to NETOPS. 

CREATE. PF=BTD0535,NF-BOOT#0535_ESCI,C-"TEST BOOT FILE NO. 3" 

This example creates an entry for a terminal user procedure (TUP) 
USER_PROCEDURE#SAM. The TUP's NOS permanent file name is 
UPROCSM. UPROCSM is stored as a private file under user name 
JOEUSER, with read permission to NETADMN and NETOPS. Alternative 
users can perform a CATLIST on the file. The network administrator, on 
NETADMN, adds the TUP to the directory, since JOEUSER does not have 
(or need) permission to access and update the directory. 

C , PF-UPROCSAM, NF=USER_PROCEDURE#SAM, UN= JOEUSER 
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DELETE (D) 

Purpose Deletes an entry in the CDCNET directory file, NETDIR. 

Format DELETE 

PF= permanent file 
NF= network file 
UN = user name 
PN=pack name 

Parameters PF= permanent file 

The permanent file to delete. If PF is specified, the entry for the specified 
permanent file is deleted. Either PF or NF (CDCNET file name, below) is 
required. If both PF and NF are specified, PF is ignored. If only PF is 
specified, you must execute NETFM from the user name under which the 
file is actually stored. 

NF= network file 

The CDCNET file name. Either NF or PF is required to indicate which 
entry to delete. If both NF and PF are specified, PF is ignored. For faster 
processing, use NF instead of PF whenever possible. Wildcard characters 
are allowed in the CDCNET file names on DELETE. 

UN = user name 

User name under which the file is stored. If UN is specified, NETFM uses 
the user name specified. If you omit UN, the user name in the directory 
entry for the file is used. If you only specify PF, the user name in the 
directory entry must match the user name under which you are running 
NETFM. 

PN=pack name 

Auxiliary device name. If PN is specified, the permanent file on the 
specified auxiliary pack is deleted. PN must match the pack name stored 
in the directory entry. If PN is (zero), the permanent file residing on the 
system default family is deleted. Default is to ignore the auxiliary device 
name when searching the directory. 

Examples This example deletes the directory entry for an ESCI boot file, 
BOOT#0534_ESCI. 

DELETE , NF=BOOT#0534_ESCI 

DELETED B0OT#0534_ESCI BT57AFA IND DAT0214 84/03/25. 84/03/26. 

11 F 09.35.01. 09.35.01. 

TEST BOOT FILE NO. 2 
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LIST (L) 



Purpose Lists a CDCNET directory entry or entries. Entries listed are controlled by 
the LIST parameters. You may list a single entry or all entries in the 
directory. Entries are in alphabetical order by network file name if 
NETFM is built with the SORT default on your operating system. If 
NOSRT5 option is selected or if SORT5 does not exist on the system, 
entries are not to be sorted in the output. 

Format LIST 

PF= permanent file 
NF = network file 
UN = user name 
PN=pack name 
LO=list option 

Parameters PF=permanent file 

The permanent file associated with the directory entry to be listed. If PF 
is specified, only the entry for the specified the permanent file is listed. 
Either PF or NF is required. If neither NF nor PF is specified, all entries 
are listed. If both PF and NF are specified, PF is ignored. 

NF=network file 

The CDCNET file name. If NF is specified, only the directory entry for the 
specified CDCNET file is listed; PF is ignored. Either NF or PF is 
required. For faster processing, use NF instead of PF. Wildcard characters 
are allowed in CDCNET file names on LIST. 

UN = user name 

User name under which a file is stored. If UN is specified, NETFM uses 
the user name specified when searching for the directory entry to list. If 
you omit UN, the user name in the directory entry is used. If you only 
specify the PF, the user name in the directory entry must match the user 
name under which you are running NETFM. 

PN=pack name 

Auxiliary device name. If PN is specified, only entries for files on the 
auxiliary pack named here are listed. If PN is (zero), only entries for the 
files residing on the family device are listed. Default is to ignore the 
auxiliary device name when searching the directory. 

LO=list option 

List option desired. The allowed options are as follows: 



Value 



Description 



F 



blank 

(LO omitted) 

Default is blank. 



Full listing of directory entries, including all pertinent 
information about the files from the directory entries. 

Only CDCNET file names are listed. 
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Examples This example lists the full directory entry for a CDCNET dump file 
DUMP#FULL_08002510007F_850220103035. 

LIST , NF«DUMP#FULL_080025 1 0007F_850220 103035 , LO=F 

DUMP#FULL_0 DF42AA DIR DL1 CXN0316 PACKNET 85/02/20. 85/02/20. 
8002510007F 9 F 10.30.35. 10.30.35 

.850220103035 
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PURGE (P) 

Purpose Purges a NOS permanent file and deletes the file's CDCNET directory 
entry. You must be validated to purge the permanent file. If you try to 
purge a file without being validated, the directory entry is deleted. 

Format PURGE 

PF= permanent file 
NF=network file 
UN=user name 
PN=pack name 
PW=password 

Parameters PF= permanent file 

Permanent file to purge. If specified, the permanent file is purged and its 
directory entry is deleted. Either PF or NF is required. If both PF and NF 
are specified, PF is ignored. If only PF is specified, you must execute 
NETFM from the user name where the file is stored. 

NF= network file 

CDCNET file name. If NF is specified, the CDCNET file is purged and its 
directory entry is deleted. Either NF or PF is required. If NF and PF are 
specified, PF is ignored. For faster processing, use NF instead of PF. 
Wildcard characters are allowed in CDCNET file names on PURGE. 

UN = user name 

User name where the file is stored. If UN is specified, NETFM uses the 
specified user name to search for the file to purge. If you omit UN, the 
user name in the directory entry for the file is used when NF is specified, 
and the job's current user name is used if only PF is specified. 

PN=pack name 

Auxiliary device name. If PN is specified, the permanent file on the 
specified auxiliary pack is deleted. The pack name must match the pack 
name stored in the directory entry. If PN is (zero), the permanent file 
residing on the system default family is deleted. Default is to ignore the 
pack name when searching the directory. 

PW=password 

Password required to purge the permanent file. 

Examples This example purges CONFIGURATION#08002510007F and its directory 
entry. The response follows. 

PURGE, NF=CONFIGURATION#08002510007F 



PURGED CONFIGURATIONS C 123456 DIR 
8002510007F 53 



NETOPS 84/03/22. 84/03/22. 
F 15.35.01. 17.50.15 
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UPDATE (U) 

Purpose Updates the CDCNET directory to match the NOS permanent file base. If 
no parameters are specified, all directory entries are updated. 

If the ABORT option has been specified on the NETFM command, and one 
or more matching entries cannot be updated (file either is missing or 
cannot have a CATLIST performed on it), NETFM aborts after updating all 
matching entries that can be updated. 

Format UPDATE 

PF= permanent file 
NF= network file 
UN = user name 
PN=pack name 
C= comment 
RT= retain timer 

Parameters PF= permanent file 

The permanent file for which the directory entry is to be updated. If PF is 
specified, only the entry for the special permanent file is updated. If PF 
and NF are specified, PF is ignored. If only PF is specified, you must 
execute NETFM from the user name under which the file is actually 
stored. 

NF= network file 

The CDCNET file name. If NF is specified, only the directory entry for the 
specified CDCNET file is updated; PF is ignored. Use NF instead of PF for 
faster processing. Wildcard characters are allowed in CDCNET file names 
on UPDATE. 

UN = user name 

User name under which the file is stored. If UN is specified, NETFM uses 
the specified user name when searching for the file to be used for updating 
the directory entry. If you omit UN, the user name specified in the 
directory entry is used when NF is specified, and the job's current user 
name is used if only PF is specified. 

PN=pack name 

Auxiliary device name. If PN is specified, only entries for files on the 
specified auxiliary pack are updated. If PN=0, only entries for files on the 
family device are updated. Default is to ignore the auxiliary device name 
when searching the directory. 

C=comment 

Comments to be updated or added for the directory entry. Comments are 
specified as a string surrounded by quotation marks ("). If comments are 
specified, they replace comments currently stored in the directory entry. 
Comment strings can range from 1 through 50 6-bit display code 
characters. Additional characters are truncated. If the string contains a 
quotation mark, two consecutive quotation marks must be used to designate 
a quotation mark in the comment text. 
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RT=retain timer 

Value for the retain flag in the directory entry, which determines the 
directory access and NOS permanent file attachment process. This 
parameter is not normally needed on UPDATE; it is meaningful only for 
files accessed by Network File Server (NETFS). Allowable keyword values 
are the following: 



Value Description 



Y Set retain flag. 

N Do not set retain flag. 

Default is N. 

If RT=Y, directory access and attachment of files are performed by 
NETFS only the first time inactive files are opened. Files remain attached 
by NETFS until one of the following conditions occurs: 

• The network shuts down. 

• NETFS terminates abnormally. 

• The NETFS retain timer for the file expires. 

See the CREATE description for default retain timer values for files 
supported by NETFS. 

If RT = N, NETFS accesses the directory and attaches a permanent file 
each time it receives a request to open a file while a file is inactive. To 
reduce performance overhead and central memory requirements, specify 
RT=Y for files that NETFS frequently accesses, such as library files. 
RT=Y should be set for MODULE*. 

Remarks If the permanent file for an entry does not exist, NOS issues a dayfile 
message indicating that the file was not found, along with the CDCNET 
file name and NOS permanent file name. Only entries for files on which 
you can perform CATLIST and ATTACH are updated. See the section on 
permanent file commands in the NOS Reference Set, Volume 3, for 
restrictions on the CATLIST command. 

When executing UPDATE, NETFM internally gets or attaches the 
permanent files specified by PF or NF using local file ZZZZZFM. To 
prevent file-busy errors, return all direct access files in write mode to be 
accessed by UPDATE before accessing NETFM. 
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Examples This example changes the retain timer for object library file, 
MODULE#0635. 

UPDATE , NF=MODULE#0635\ RT=Y 

UPDATED MODULE#0635 L700635 IND ABC0123 84/08/01. 84/08/02. 

D1 20 F 16.12.01. 16.22.45. 

This example attempts to change the retain timer for terminal user 
procedure USER_PROCEDURE#l. However, since NETFM can't find a 
NOS permanent file for USER_PROCEDURE#l, the update does not 
succeed. 

UPDATE ,NF=USER_PR0CEDURE#1 ,RT=Y 

•••NO PERM FILE OR NOT CATLISTABLE,NF=USER_PR0CEDURE#1 

This example attempts to update the directory entry for DI configuration 
procedure CONFIGURATION#08002510007C, but the entry for the file 
cannot be found. 

U,NF=CONFIGURATION#08002510007C,PF=C10007C 

•••ENTRY NOT FOUND IN CDCNET DIRECTORY. 
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VERIFY (V) 

Purpose Verifies that a NOS permanent file exists for a CDCNET directory entry. 

If no parameters are specified, all directory file entries are verified. 

You can use VERIFY directive after changing NOS permanent files. For 
example, you can check if any files have been inadvertently purged but not 
removed from the directory. 

Only entries for files on which you can execute CATLIST or ATTACH are 
verified. See the section on permanent file commands in the NOS 
Reference Set, Volume 3, for restrictions on the CATLIST. 

If the ABORT option has been specified on the NETFM command and if 
one or more matching entries cannot be verified (file either is missing or 
cannot have a CATLIST or ATTACH performed on it), NETFM aborts after 
verifying all of the verifiable matching entries. 

Format VERIFY 

PF= permanent file 
NF = network file 
UN = user name 
PN=pack name 

Parameters PF= permanent file 

The permanent file for which the directory entry is to be verified. If PF is 
specified, only the entry for the specified permanent file is verified. If PF 
and NF are specified, PF is ignored. 

NF=network file 

The CDCNET file name. If NF is specified, only the directory entry for the 
specified CDCNET file is verified; PF is ignored. For faster processing, use 
NF instead of PF whenever possible. Wildcard characters are allowed in 
CDCNET file names on VERIFY. 

UN = user name 

User name under which the file is stored. If UN is specified, NETFM uses 
the specified user name when searching for the file to verify against its 
directory entry. If you omit UN, the user name in the directory entry is 
used when NF is specified, and the job's current user name is used if only 
PF is specified. 

PN=pack name 

Auxiliary device name. If PN is specified, only entries for files on the 
specified auxiliary pack are verified. If PN=0, only entries for files on the 
family device are verified. Default is to ignore the auxiliary device name 
when searching the directory. 
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Remarks When executing VERIFY, NETFM internally uses GET and ATTACH to 
access the permanent files specified by PF or NF (using local file 
ZZZZZFM). To prevent file-busy errors, return all direct access files in 
write mode to be accessed by VERIFY before accessing NETFM. 

Examples This example verifies the directory entry for boot file called BOOT#0524 
MCI. 

VERIFY , NF=B00T#0524_MCI 

VERIFY GOOD, NF=BOOT#0524_MCI . 

This example uses wildcard characters to specify that all directory entries 
for boot files should be verified. The VERIFY directive uses an asterisk (*) 
after BOOT#. Responses show whether each verification succeeds or fails. 

V.NF=BOOT#* 

VERIFY GOOD, NF=BOOT#0527_ESCI. 

VERIFY GOOD, NF=BOOT#0527_MCI . 

•••VERIFY ERRORS. 

•••NO PERM FILE OR NOT CATLISTABLE,NF=BOOT#0529_MCI 
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Other NOS Network File Management Commands 

Three additional utilities aid in NOS CDCNET directory and file management. These 
utilities are briefly described here. Messages generated by the utilities are listed in the 
NOS Operations handbook. 

Utility Description 

NETBDF Builds a directory file with file name NETDIR in the current user's 

permanent file catalog. NETBDP runs as part of the CDCNET 
installation process. NETBDF may also be used if a new directory must 
be built. 

NETMDF Merges directory files. Takes an existing directory and adds entries in 

that file to another directory. Checks for duplicate entries. 

NETRDF Restructures a directory file. Creates a new version of the directory so 

more entries can be added to it without degrading performance. 
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NETBDF (Build CDCNET Directory File) 

Purpose Builds a CDCNET directory file named NETDIR in the catalog of the 
current user. Initializes directory for use by NETFM and NETPS. 
Optionally gives other users write permission on the directory. NETBDF 
runs automatically as part of CDCNET installation, and creates NETDIR 
on user name NETOPS. You can also use NETBDF to build a new 
CDCNET directory. 

Format NETBDF 

NF=number of files 
I = input file 
delete option 

Parameters NF=number of files 

Total number of file entries the directory is expected to contain. NF may 
range from through 10000. Default is 50 entries. 

I = input file 

Input file containing user names with write permission on the directory. 
The I parameter may have the following values: 



Remarks 



Value 



Description 



I 
I=lfnl 

1 = 

I (omitted) 



User names with write permission are on file INPUT. 

User names with write permission are on local file lfnl 
(file name of your choice). 

No user names are to be granted write permission. 

User names with write permission are on file INPUT. 



Default is I (omitted). 

delete option 

Delete option, specified by the keyword DELETE. If specified, the old 
CDCNET directory (if one exists) is deleted. If you don't specify DELETE 
and a directory already exists under this user name, NETBDF aborts with 
a dayfile message. 

The input file specifying user names having write permission on the 
directory must be in display code, with one user name per line. Do not use 
characters such as periods or commas. At a minimum, the input file 
usually contains NETADMN. 

After the directory has been created, you can add and delete user names 
having write permission on the directory using the PERMIT command. 

Directory processing efficiency degrades if the directory contains more than 
160 percent of the entries it was expected to contain. 
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Examples This example builds a CDCNET directory expected to have 45 entries. 

NETBDF , NF=45 , I-DIRUSER 

Input file DIRUSER contains these user names permitted to update the 
directory: 

NETADMN 
INSTALL 
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NETMDF (Merge CDCNET Directory Files) 

Purpose Merges CDCNET directory files. Moves directory entries from one directory 
file (source directory) to another directory file (destination directory). 
Checks files for duplicate entries. The user name you use to log in to NOS 
is the user name under which the destination directory is stored. 

Format NETMDF 

UN = user name 1 
F= permanent file 
move option 
replace, option 
SA = user name% 
secure option 

Parameters UN = user name^ 

User name under which the source directory resides. 

F=permanent file 

Permanent file name of the source directory to be merged with NETDIR. 
This file is in the catalog of the current user name (running the current 
job). 

move option 

Move option, specified by the keyword MOVE. If present, moves NOS 
permanent files associated with CDCNET file names in the source directory 
from their current location to the catalog of the user executing NETMDF. 
If omitted, no NOS permanent files are moved. 

replace option 

Replace option, specified by the keyword REPLACE. If present, replaces 
duplicate directory entries in the destination directory with entries from 
the source directory. If omitted and if matching directory entries exist, 
matching entries in the destination directory are not modified. 

SA=user name% 

Site administrator's user name. If specified, and if files are moved by the 
MOVE option, the site administrator's user name is granted explicit write 
permission on any moved permanent files. Write permission is granted 
whether or not moved files have secure permanent file attributes (see 
secure option, next). 

secure option 

Secure option, specified by the keyword SECURE. If specified, files moved 
to the catalog of the destination directory's user name have secure 
permanent file attributes, regardless of attributes of original files, Secure 
permanent file attributes include the following: 

CATEGORY= PRIVATE 
MODE = READ 
ALTERNATE CATLIST=NO 

If move option is omitted, moved files have the same attributes as the 
original file, provided the original file's attributes include ALTERNATE 
CATLIST=YES. Otherwise, files have the secure file attributes shown 
above. 
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Remarks Use caution when several directory entries refer to the same permanent 
file name, even if they are under different user names. 

Examples A network administrator at an interactive terminal uses NETBDF to build 
a source directory on NETADMN. Next, the administrator moves to the 
system console and logs in to NOS on user name NETOPS. The 
administrator enters NETMDF to merge the directory on NETADMN with 
the destination directory on NETOPS: 

NETMDF UN=NETADMN. 
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NETRDF (Restructure CDCNET Directory FUe) 

Purpose Restructures a CDCNET directory file. Creates a new version of the 

directory file that is structured more efficiently. The directory can grow to 
approximately 160 percent of the expected entries before performance 
begins to be degraded. 

Format NETRDF 

NF= number of files 

Parameters NF= number of files 

Total number of file entries the directory file is expected to contain. 
Default is twice the number of entries currently in the existing CDCNET 
directory file. 

Examples NETRDF , NF = 1 00 . 
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Network Procedure Library Manager (NETPLM) 

Network Procedure Library Manager (NETPLM) is a NOS utility that manages 
CDCNET procedure libraries for DI system configuration procedures, terminal definition 
procedures (TDPs), terminal user procedures (TUPs), and load procedures (LPs). 
NETPLM adds, deletes, and lists procedures in a procedure library. 

Network File Manager (NETFM) is still used to manage exception lists and dump files, 
as well as individual configuration procedures before they are merged into a procedure 
library. In addition, NETPLM uses NETFM's routines to access the CDCNET directory 
and attach procedure library files. However, since most CDCNET configuration 
procedures are stored in procedure libraries on NOS, NETPLM is the main utility used 
to manage CDCNET configuration procedures. 

NOTE 

If your CDCNET directory contains entries for an individual configuration procedure 
and a configuration procedure library entry of the same name, Network File Server 
accesses the individual configuration procedure instead of the one in the procedure 
library. 



There are procedures that help you use NETPLM: GETCP and REPCP. These 
procedures execute NETFM and NETPLM directives required for CDCNET 
configuration procedures and procedure libraries on NOS. 

NETPLM Overview 

When NETPLM executes, it does the following: 

1. Parses and validates NETPLM command parameters. 

2. Determines files to be accessed, and the manner in which they are accessed. 

3. Validates the input files. Input files include the addfile, the file of procedures to be 
added. The addfile is specified by the A parameter on the NETPLM command. 
Input files also include the input file of NETPLM directives, specified by the I 
parameter on the NETPLM command. From these input files, NETPLM identifies 
required operations. During validation, NETPLM checks for correct procedure 
format, such as PROC and PROCEND statements. If input files are invalid, 
NETPLM aborts after identifying the errors. 

4. If the operational CDCNET procedure library is to be modified, the procedure 
library is attached (by NETFM) in write mode through the network directory. The 
procedure library is then immediately reattached in read mode. This allows 
Network File Server (NETFS) to access the file, but locks out any other attempted 
NETPLM updates on the procedure library. The procedure library is copied into a 
temporary file. If an operational procedure library attached by NETFM is not to be 
modified, the operational library is returned. 

5. Procedures in the addfile are added or replaced in the procedure library. If more 
than one procedure of the same name exists in the addfile, the last one in the 
addfile is added or replaced. 

6. NETPLM directives are processed in the order they occur in the input file. 
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7. The temporary copy of the new procedure library is copied into the file specified on 
the NETPLM command. If the file to be updated is the operational CDCNET 
procedure library, it is reattached in write mode, and the temporary copy of the 
new library is copied into it. Then, the operational procedure library is returned or 
replaced. If the operational CDCNET procedure library is busy, the new procedure 
library is written to local file ZZZZZNL. NETPLM waits until the operational 
procedure library is no longer busy to copy the new library into the operational 
library, or until a user break 2 is entered (NETPLM aborts). 

8. Temporary files are cleaned up and NETPLM terminates. 
Library File Interlock 

A library file interlock occurs only when NETPLM's NL and PL parameters specify 
that an operational procedure library is being updated. NETPLM initially attaches the 
operational procedure library file in write mode. If any user (including NETFS) has 
this file attached, a file-busy message is sent to the user, and NETPLM waits for the 
file to be available. Once the file is attached, NETPLM immediately changes the mode 
to read without releasing the file. No other NETPLM command can attach the file, 
because its write access request fails while the original NETPLM command keeps the 
file in read mode. NETPLM then creates a new procedure library on a local file. When 
the new library is created, NETPLM attempts to change its attach mode to write (if 
the file is busy, NETPLM informs the user and waits until the file is not busy). Once 
NETPLM gets the old library file in write mode, it copies the local file version of the 
• new library onto the permanent file, then returns the file. 

This library file interlock works only for direct access files. If you use indirect access 
files for your procedure libraries, NETPLM still runs correctly, but without the file 
interlock. 

File Permissions and Constraints 

To use NETPLM, you must have read permission to the CDCNET directory (NETDIR). 
You must also have read and write permissions for the operational procedure libraries 
to list or modify any of the procedures in the libraries. 

Multiple NETPLM operations can run concurrently. However, a file interlock prevents 
procedures from being overwritten by allowing only one modification operation at a 
time per library (see Library File Interlock). For the interlock to work, use direct 
access rather than indirect access files for procedure libraries. If you use indirect 
access files, your files may be overwritten. 
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NETPLM Command 

Purpose Accesses Network Procedure Library Manager (NETPLM), which allows 
you to add, delete, and list procedures on a CDCNET procedure library. 
The PL, NL, and UN parameters allow you to directly modify operational 
procedure libraries while your network is running. All file name 
parameters can specify local files. Parameters cannot be specified in 
positional format (that is, use the format: parameter _name= parameter _ 
value). 

Format NETPLM 

A=addfile 
abort option 
G=getfile 
I=input file 
L=list file 
NL=new library 
PL=previous library 
PT= procedure type 
replace option 
UN = user name 
z option 

Parameters A =addfile 

The local file containing new or replacement procedures to be used to 
update the procedure library (the addfile). You can specify a file name of 
your choice (A=filename), use A as a keyword, specify A=0, or omit A. 
Procedure adding or replacing (see following description of replace option) 
always occurs before any directives on the input file (see I parameter) are 
processed. If A is a keyword, the default is ADDFILE. If A is omitted or 
A=0, no procedures are added or replaced. 

abort option 

Abort option, specified by the keyword ABORT. This option specifies 
whether or not NETPLM should process directive warnings as errors. If 
ABORT is specified, a directive warning causes NETPLM to abort (after 
scanning directives for more errors). If ABORT is omitted, directive 
warnings do not cause NETPLM to abort. 

G=getfUe 

The local file in which procedures requested on GET directives (see I 
parameter) are listed (the getfile). You can specify a file of your choice, 
use G as a keyword, specify G=0, or omit it. If G is a keyword, the 
default is GETFILE. If G is omitted or G=0, no procedures are listed. 
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I = input file 

The name of a local file containing one or more NETPLM input directives. 
You can specify a file of your choice, use I as a keyword (specify I without 
a parameter value), specify 1 = 0, or omit I. If I is omitted or specified as a 
keyword, the directives are read from file INPUT. If 1 = 0, no directives are 
read. Directives are processed in order of their occurrence in the directive 
file. If the Z parameter is specified, its directives override any directives 
on the directive file. 

The following NETPLM directives can be used in the directive input file: 



NETPLM Directive 



Description 



DELETE procname 
D procname 

GET procname or 
G procname 



LISTNAMES or LN 



LISTPROC procname or 
LISTPROCS procname or 
LP procname 



Specifies a procedure to be deleted from the 
library. 

Specifies a procdure name (procname) with 
text to be written to the file specified on the 
G parameter. Text is from the current library, 
with all changes up to this directive. If you 
specify an asterisk (*) for procname, the text 
of all procedures in the current library is 
written in alphabetical order to the file 
specified on the G parameter. 

Specifies that the names of all the procedures 
in the current library are listed in 
alphabetical order to the file specified on the 
L parameter. 

Specifies that the text of the procedure on this 
directive is listed in the file specified on the L 
parameter. If you specify an asterisk (*) for 
procname, the text of all procedures in the 
current library is listed in alphabetical order 
in the file specified on the L parameter. 



L=list file 

The local file to which NETPLM output, such as lists of procedure names 
or procedure listings, is written. This file includes a list of all changes or 
change errors for all procedures added, replaced, listed, and deleted. 

You can specify a file of your choice, use L as a keyword (specify L 
without a parameter value), specify L=0, or omit L. If no file name is 
specified (L as a keyword value, L=0, or L omitted), the default is 
OUTPUT. 

If a LISTNAMES directive is specified in a NETPLM session, the list file 
contains a list of all procedure names on the current library and all 
changes made up to the LISTNAMES directive. 

If a LISTPROC directive is specified in a NETPLM session, the list file 
contains the text of procedures in the current library. 
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NL=new library 

The local file to which the new library is written. You can specify a file of 
your choice, use NL as a keyword (specify NL without a parameter value), 
specify NL=0, or omit NL. If NLds a keyword, NETPLM attempts-to 
update the actual procedure library using the new library- If NL=0, no 
new library is generated. If NL is omitted, the new library is written onto 
a local file named xxxxLIB, where xxxx is the procedure type specified on 
the PT parameter (TDP, TUP, SC, or LP). The resulting file names are 
TDPLIB, TUPLIB, SCLIB, and LPLIB, respectively. The NL file is rewound 
before and after NETPLM processing (procedure libraries are expected to 
be a single record). 

PL = previous library 

The local file containing the procedure library to be updated. You can 
specify a file of your choice, use PL as a keyword (specify PL without a 
parameter value), specify PL=0, or omit PL. If PL is specified as a 
keyword, or PL is omitted, NETPLM attempts to use the operational 
(NETDIR-specified) procedure library as the previous library. If PL=0, no 
previous library is used, and the new library only contains procedures from 
the addfile. The PL file is rewound before and after NETPLM processing 
(procedure libraries are expected to be a single record). 

PT= procedure type 

The type of procedure library to be updated. This parameter is required 
and has no default. The following values are allowed. 

Keyword Value Description 

SC DI system configuration procedure 

TDP Terminal definition procedure 

TUP Terminal user procedure 

LP Load procedure 

replace option 

Replace option, specified by the keyword R. R specifies whether or not 
replacing procedures in the library with procedures from the addfile is 
allowed. If R is specified, replacing existing procedures in the library with 
procedures from the addfile is allowed. If R is omitted, replacing existing 
procedures is not allowed. 

UN = user name 

The user name from which the network directory (NETDIR) is accessed. 
UN is ignored unless the operational library access option is selected by 
PL or NL. You can specify a user name of your choice, specify UN as a 
keyword (specify UN without a parameter value), or omit UN. If a value is 
specified for UN, the NETDIR in the specified user name is accessed. If 
UN is specified as a keyword, the NETDIR in the user name specified by 
NETFM's secondary default (NETOPS, in the released software) is 
accessed. If UN is omitted, the NETDIR in the current user name is 
accessed. 
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z option 

Specifies whether or not the NETPLM command, rather than a separate 
input file, contains NETPLM directives. Specify this option by the keyword 
Z. 

One or more NETPLM input directives (DELETE, GET, LISTNAMES, 
LISTPROC) are allowed on the NETPLM command. Z directives override 
directives on an input file. 

If the Z option is used, the NETPLM command has the following structure: 

NETPLM,param 1 param n Z./dir 1 /dir 2 ../dir n 
where: 



Parameter 



Description 



paramj param n 
period (.) 

slash (/) 



/dir 1 /dir 2 ../dir n 



One or more NETPLM parameters. 

The NETPLM command terminator. Directives 
begin after the period. 

The directive delimiter. This delimiter is the first 
character following the NETPLM command 
terminator. It can be any character except a 
blank, and should be used consistently within the 
command. 

One or more NETPLM directives, separated by the 
directive delimiter. 



Using the Z option, the NETPLM command and its directives must be 80 
characters or less. 

If Z is not specified on the NETPLM command, it is assumed that input 
directives are in an input file specified on the I parameter. 

Responses NETPLM messages are documented in the NOS 2 Operations handbook. 

Remarks Two or more of the A, G, and L parameters cannot specify the same file 
name. 

Files (other than those specified by PL and NL) are not positioned before 
NETPLM processes them. After processing, files are positioned at the EOF 
or EOR following processed data. 

Examples This example adds procedures on file NEWPROC to the operational TUP 
library on user name NETADMN. No directive is required. Output goes to 
file OUTPUT. 

NETPLM, I =0 , NL , A=NEWPROC , UN-NETADMN , PT-TUP 

This example lists names of procedures, and text TESTl procedure in the 
operational TUP library on file LIST. The Z parameter is used to add 
NETPLM directives after the NETPLM command. A semicolon is used as 
the directive delimiter. 

NETPLM(PL,UN.PT=TUP,L=LIST,Z) ; LISTNAMES; LISTPROC TEST1 
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Library File Installation 

After a procedure library is generated, it should have an entry in the CDCNET 
network directory, so it can be accessed by Network File Server (NETFS). If a 
directory entry does not exist for a procedure library on the network directory 
(NETDIR), you must add an entry using NETFM (see NETFM section of this 
appendix). The NOS CDCNET installation procedures install initial default procedure 
libraries and their directory entries. 

When procedure libraries are processed as local files, it is your responsibility to copy 
the resulting new procedure library into the actual permanent file (as specified on 
NETDIR). 

If no previous library (PL parameter) exists, you can specify PL=0 on the NETPLM 
command. NETPLM then generates a new library (NL parameter) which only contains 
procedures from the addfile. If no addfile is specified on the NETPLM command, the 
new procedure library NETPLM generates is empty. 

File Formats 

The following sections describe format requirements for files used with NETPLM. 

Addfile (A Parameter) 

The addfile is a local 6/12 ASCII file containing one or more new or modified 
procedures. This file is optional. If omitted on the NETPLM command, no procedures 
are added or replaced in the procedure library. The addfile can have any name. 

The following format conventions apply to procedures specified in the addfile: 

• Procedures must begin with a PROC statement and end with a PROCEND 
statement. 

• Each procedure name must be 31 or fewer alphanumeric and special characters 
(special characters include #, _, @, and $). 

• All procedure names should be unique in the procedure library. If a duplicate 
procedure name is added to the procedure library, the duplicate replaces the older 
procedure. 

• Multiple blanks, commas, comments, and line continuations are allowed. 

• All comment lines after the BOI or the previous procedure's PROCEND statement 
are considered part of the procedure. 

• The PROCEND statement can optionally include the procedure's name, which must 
match the name specified on the PROC statement. 
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Input Directive File (I Parameter) 

The input directive file is a local 6/12 ASCII file containing directives for processing 
the procedure library. This file is optional, and is used when deleting or listing 
procedures in the procedure library (using DELETE, GET, LISTNAMES, and 
LISTPROC directives). 

The following format conventions apply to directive files: 

• The directive file may contain one or more directives. 

• One or more blanks can separate the directive command (such as D, G, LN, LP, 
DELETE, GET, LISTNAMES, LISTPROC, and LISTPROCS) from the procedure 
name. 

• Only one directive is allowed per line. 

• Blank lines are allowed. 

NETPLM Interactive Directive Mode 

You can enter NETPLM directives in interactive directive mode. To use this mode, 
specify a file assigned to an interactive terminal device as the input file (I parameter), 
and a file assigned to an interactive terminal for the output parameter (L parameter) 
(only possible when NETPLM is run from IAF). Normally, files INPUT and OUTPUT 
are assigned to the terminal for an interactive job. In interactive directive mode, 
directives are read from the keyboard. NETPLM sends a prompt (?) for each directive. 
As each directive is read and processed, output is sent to the terminal screen. 
NETPLM prompts for, and processes, more directives until you enter a carriage return 
without directives, signifying the end of directive input. In interactive directive mode, 
directive errors are not fatal. NETPLM identifies the error and prompts you to reenter 
acorrected directive. 

list File (L Parameter) 

If no fatal validation errors occur, the list file contains the following: 

• A list of procedures added or replaced in the library (if any) 

• A list of directives processed (if any) 

• The resulting listings of any LISTPROC and LISTNAMES directives 

If a fatal validation error occurs, the list file contains the following message: 

FATAL ERROR FOUND 
followed by two list sections: 

• ADDFILE SUMMARY: Lists procedures in the addfile as valid or invalid, and 
indicates errors. 

• INPUT DHIECTIVES: Lists all directives and indicates errors. 



C-38 CDCNET Commands 60000414 C 



File Formats 



If a fatal error occurs, or a nonfatal error occurs and ABORT was specified on the 
NETPLM command, NETPLM terminates without updating the procedure library. 

Format control characters are written into the file specified on the L parameter, unless 
the file is assigned to a terminal output device. 

Getfile (G Parameter) 

The text of one or more of the procedures on a procedure library can be put in the 
getfile (G parameter) using GET directives. The getfile contains procedures in the same 
format as those originally entered through the addfile. Once procedures are copied into 
the getfile, they can be modified and added back into the procedure library as an 
addfile during a later NETPLM run. 

ZZZZZNL (Temporary New Library) 

If the new procedure library cannot be written onto the CDCNET operational procedure 
library because the operational procedure library file is busy, local file ZZZZZNL 
contains the new procedure library when NETPLM aborts. You may then use this file 
to manually update the operational library. 

CAUTION 



Ensure that no other updates of the operational library have occurred; otherwise the 
update with new library on ZZZZZNL destroys other changes. 



Example File Diagrams 

Figures C-l and C-2 show general formats of files read by NETPLM. While the 
examples use procedure type TUP, the same format is used for procedure types TDP, 
SC, and LP. 











PROC TUPNAME1 

Tupl text 

PROCEND TUPNAME1 
PROC TUPNAME2 

TUP2 text 
PROCEND 
PROC TUPNAMEn 

TUPn text 
PROCEND 











Figure C-l. Addfile Format Example 



NOTE 



All procedure names are unique, and may be up to 31 alphanumeric characters, plus 
special characters #, @, _, and $. 
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DELETE TUPNAME1 
G TUPNAME2 
LISTPROCS 



D TUPNAME4 
GET TUPNAME5 
LISTNAMES 



Figure C-2. Directive Input File Format Example 
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Manage CDCNET Configuration (MANCC) 
Utility D 

This appendix shows how to access the Manage CDCNET Configuration (MANCC) 
utility. It also summarizes the MANCC subcommands. Complete instructions on using 
MANCC are in the CDCNET Configuration Guide. 
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Accessing MANCC 

This section describes how to access MANCC on NOS/VE and NOS. 
NOTE 



Before using MANCC, check if your terminal supports a screen mode file editor. See 
the NOS/VE File Editor Tutorial/Usage or the NOS Full Screen Editor User's Guide for 
details on modifying EDIT_FILE or FSE at your terminal. If your terminal does not 
support screen mode EDIT_FILE or FSE, you must use MANCC in line mode. 



Accessing MANCC on NOS/VE 

To access MANCC on NOS/VE, do the following: 

1. Make sure the appropriate terminal model has been specified by CHANGE _ 
TERMINAL .ATTRIBUTES. 

2. Enter: 

CREATE_COMMAND_LIST_ENTRY . . 
ENTRY=$SYSTEM . CDCNET . VERSION.INDEPENDENT . COMMANDJ.IBRARY 

This command adds MANCC commands to the set of commands you may enter. You 
might want to add this command to your user prolog. 

3. Enter: 

MANAGE _CDCNET_CONFIGURATION or 
MANCC 

INPUT = file reference 
VERSION = 0..FFFFC16) 
STATUS = status variable 

INPUT (I) 

The input file from which MANCC reads subcommands. Default is $COMMAND. 

VERSION (V) 

The MANCC version to use for the session. The default version level is the 
value selected when MANCC is installed on the host. Each MANCC version 
generates and validates CDCNET configuration commands according to its 
corresponding CDCNET software version level. This parameter should be used 
only by CDCNET analysts who must create configuration files for DIs that are 
loaded with a CDCNET software version differing from the default. 

STATUS 

The status parameter here and on MANCC subcommands is the standard SCL 
status variable. For a description of this parameter, see the NOS/VE System 
Usage manual. 
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MANCC runs as a command utility that, except for the editing subcommand, 
operates in line mode. You can use DISPLAY_COMMAND_LIST_ENTRY (DISCLE) 
to see the list of MANCC subcommands, as in the following example. 

/mancc 
NC/dlscle 
ENTRY mancc 
Commands 



change.default 

d1sp1ay_conf1gurat1on_ftle 

quit 

wr1te_conf 1gurat1on_f 1 le 

NC/ 



create_conf 1guration_f i le 
edlt.conf iguration.fl le 
use_conf 1gurat1on_f 1 le 
val1date_conf1gurat1on_f1le 



Once you access MANCC, you can enter MANCC subcommands. The following prompt 
indicates when MANCC is ready to accept subcommands: 

NC/ 

Accessing MANCC on NOS 

To access MANCC on a NOS host, enter: 

1. SCREEN. term1nal_type 

If a screen definition is not in your user prolog, enter the SCREEN command to 
define the full screen interface for your terminal, for example, SCREEN,721. 

2. ASCII 

The ASCII command allows MANCC messages to be displayed in a readable format. 
Also, certain characters that may be in configuration files, such as @ and :, have 
different encoding formats in ASCII and NORMAL modes. 

3. MANCC, I=f 1 lename,V=vvvv 

I specifies the input file from which MANCC reads subcommands. The default for I 
depends on the job origin: 



Job Origin 



Default Input File 



Interactive 
Batch 



Interactive terminal. 

File INPUT (input is read from local file INPUT). 



If the specified input file is assigned to an interactive terminal, the MANCC main 
menu appears. 

vvvv is the version of MANCC to use (four hexadecimal digits). The default version 
level is the value selected when MANCC is installed on the host. Each MANCC 
version generates and validates CDCNET configuration commands according to its 
corresponding CDCNET software version level. This parameter should be used only 
by CDCNET analysts who must create configuration files for DIs loaded with a 
CDCNET software version differing from the default. To change the MANCC 
version level, see the SET_VERSION_LEVEL procedure in the NOS Installation 
handbook. 
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4. The MANCC main menu appears. This is the main menu where you select MANCC 
subcommands. 

MANCC Version vvvv COPYRIGHT CONTROL DATA CORPORATION yyyy, yyyy 

1. Create_Conflgurat1on_File (CRECF) 

2. Use_Configurat1on_F1le (USECF) 

3. Val1date_Configurat1on_Fi1e (VALCF) 

4. D1sp1ay_Conf1gurat1on_F1le (DISCF) 

5. Ed1t_Configurat1on_File (EDICF) 

6. Wr1te_Conf1guration_F1le (WRICF) 

7. Change_Defau1t (CHAD) 

8. Quit 

Select from the list above and press NEXT: 
NOTE 



vvvv = software version number, yyyy = year 



After accessing MANCC, you can select any MANCC subcommand. Most MANCC 
screens have a HELP function key active. 

MANCC aborts if it encounters an error when processing subcommands in batch mode, 
or when processing subcommands from an input file not assigned to an interactive 
terminal. 
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MANCC Subcommands 

MANCC subcommands are summarized in table D-l. They are described in detail in 
the CDCNET Configuration Guide. 

Table D-l. MANCC Subcommand Summary 



MANCC Subcommand 



Description 



CREATE. 

CONFIGURATION. 

(CRECF) 



.FILE 



USE .CONFIGURATION _ 
FILE (USECF) 



Creates a basic configuration file of the specified type. 
CRECF prompts for for information on the equipment 
you want to configure. MANCC combines this 
information with values it provides in the generated 
file. The generated files are limited in choices and 
parameter values, and can be modified using EDICF. 
CRECF cannot be entered in batch mode. 

Specifies the file to use with subsequent MANCC 
subcommands, such as EDICF, DISCF, WRICF, or 
VALCF. Either USECF, CRECF, or VALCF should be 
specified at the start of a MANCC session to indicate 
the current file to use with subsequent MANCC 
subcommands. 

Validates a configuration file for correct command 
syntax. The validated file can then be used with 
subsequent MANCC subcommands, such as EDICF, 
DISCF, or WRICF. You can also validate a 
configuration file during an EDIT_CONFIGURATION_ 
FILE session using the VALDAT editing function. 

Displays a configuration file with header information 
(date, time, and file type). Used for producing 
configuration reports. The displayed file can be copied, 
viewed, and printed using operating system utilities. 

Invokes a file editor plus special features for adding 
and changing information in CDCNET configuration 
files, such as prompting for command parameters, 
syntax validation, and restricting the types of 
commands allowed in a file. EDICF cannot be entered 
in NOS batch mode. 

WRITE .CONFIGURATION. Writes a created or edited file to another file. 
FILE (WRICF) 



VALIDATE. 

CONFIGURATION .FILE 
(VALCF) 



DISPLAY. 

CONFIGURATION .FILE 
(DISCF) 



EDIT.CONFIGURATION . 
FILE (EDICF) 



CHANGE .DEFAULT 
(CHAD) 

QUIT 



Changes the local file to which the output from a 
MANCC session is written. 

Ends a MANCC session. 
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NOTE 



Control Data no longer supports NETCU. 
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This appendix lists the ASCII character set, with conversions to decimal, hexadecimal 
and octal codes. 



Table F-l. ASCII Character Set 



OXCHDNCOLNCOLNCOL Mnemonic 
Name or Meaning 



000 
001 
002 
003 

004 
005 
006 
007 

008 
009 
010 
011 

012 
013 
014 
015 

016 
017 
018 
019 

020 
021 
022 
023 

024 
025 
026 
027 

028 
029 
030 
031 



00 


000 


NUL 


01 


001 


SOH 


02 


002 


STX 


03 


003 


ETX 


04 


004 


EOT 


05 


005 


ENQ 


06 


006 


ACK 


07 


007 


BEL 


08 


010 


BS 


09 


Oil 


HT 


OA 


012 


LF 


0B 


013 


VT 


0C 


014 


FF 


0D 


015 


CR 


0E 


016 


SO 


OF 


017 


SI 


10 


020 


DLE 


11 


021 


DC1 


12 


022 


DC2 


13 


023 


DC3 


14 


024 


DC4 


15 OvTEM 


025 


NAK 


17 


026 


SYN 




027 


ETB 


18 


030 


CAN 


19 


031 


EM 


1A 


032 


SUB 


IB 


033 


ESC 


1C 


034 


FS 


ID 


035 


GS 


IE 


036 


RS 


IF 


037 


US 



Null 

Start of heading 
Start of text 
End of text 

End of transmission 
Enquiry 
Acknowledge 
Bell 

Backspace 

Horizontal tabulation 
Line feed 
Vertical tabulation 

Form feed 
Carriage return 
Shift out 
Shift in 

Data link escape 
Device control 1 (X-ON) 
Device control 2 
Device control 3 (X-OFF) 

Device control 4 
Negative acknowledge 
Synchronous idle 
End of transmission block 

Cancel 

End of medium 

Substitute 

Escape 

File separator 
Group separator 
Record separator 
Unit separator 



(Continued) 
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Table F-l. 


ASCII Character Set (Continued) 




Decimal 
Code 


Hexadecimal 
Code 


Octal 
Code 


Graphic or 
Mnemonic 


Name or Meaning 


032 
033 
034 
035 


20 
21 
22 
23 


040 
041 
042 
043 


SP 

! 
n 

# 


Space 

Exclamation point 
Quotation marks 
Number sign 


036 
037 
038 
039 


24 
25 
26 

27 


044 
045 
046 
047 


% 

& 
• 


Dollar sign 
Percent sign 
Ampersand 
Apostrophe 


040 
041 
042 
043 


28 
29 
2A 
2B 


050 
051 
052 
053 


( 
) 

+ 


Opening parenthesis 
Closing parenthesis 
Asterisk 
Plus 


044 
045 
046 
047 


2C 
2D 
2E 
2F 


054 
055 
056 
057 


9 

1 


Comma 
Hyphen 
Period 
Slant 


048 
049 
050 
051 


30 
31 
32 
33 


060 
061 
062 
063 




1 

2 
3 


Zero 
One 
Two 
Three 


052 
053 
054 
055 


34 
35 
36 
37 


064 
065 
066 
067 


4 
5 
6 
7 


Four 
Five 
Six 
Seven 


056 
057 
058 
059 


38 
39 
3A 
3B 


070 
071 
072 
073 


8 
9 

1 


Eight 
Nine 
Colon 
Semicolon 


060 
061 
062 
063 


3C 
3D 

3E 
3F 


074 
075 
076 
077 


< 
> 


Less than 
Equals 
Greater than 
Question mark 


064 
065 
066 
067 


40 
41 
42 
43 


100 
101 
102 
103 


@ 
A 
B 
C 


Commercial at 
Uppercase A 
Uppercase B 
Uppercase C 


068 
069 
070 
071 


44 
45 
46 
47 


104 
105 
106 
107 


D 
E 
F 
G 


Uppercase D 
Uppercase E 
Uppercase F 
Uppercase G 










(Continued) 



F-2 CDCNET Commands 



60000414 C 











Character Set 


Table F-l. 


ASCII Character Set (Continued) 




Decimal 
Code 


Hexadecimal 
Code 


Octal 
Code 


Graphic or 
Mnemonic 


Name or Meaning 


072 
073 
074 
075 


48 
49 
4A 
4B 


110 
111 
112 
113 


H 
I 
J 
K 


Uppercase H 
Uppercase I 
Uppercase J 
Uppercase K 


076 
077 
078 
079 


4C 
4D 

4E 
4F 


114 
115 
116 
117 


L 

M 
N 
O 


Uppercase L 
Uppercase M 
Uppercase N 
Uppercase O 


080 
081 
082 
083 


50 
51 
52 
53 


120 
121 
122 
123 


P 

Q 
R 

S 


Uppercase P 
Uppercase Q 
Uppercase R 
Uppercase S 


084 
085 
086 
087 


54 
55 
56 
57 


124 
125 
126 
127 


T 
U 
V 

w 


Uppercase T 
Uppercase U 
Uppercase V 
Uppercase W 


088 
089 
090 
091 


58 
59 
5A 
5B 


130 
131 
132 
133 


X 
Y 
Z 

[ 


Uppercase X 
Uppercase Y 
Uppercase Z 
Opening bracket 


092 
093 
094 
095 


5C 
5D 

5E 
5F 


134 
135 
136 
137 


\ 
] 


Reverse slant 
Closing bracket 
Circumflex 
Underline 


096 
097 
098 
099 


60 
61 
62 
63 


140 
141 
142 
143 


a 
b 
c 


Grave accent 
Lowercase a 
Lowercase b 
Lowercase c 


100 
101 
102 
103 


64 
65 
66 
67 


144 
145 
146 
147 


d 

e 
f 
g 


Lowercase d 
Lowercase e 
Lowercase f 
Lowercase g 


104 
105 
106 
107 


68 
69 
6A 
6B 


150 
151 
152 
153 


h 
i 

J* 
k 


Lowercase h 
Lowercase i 
Lowercase j 
Lowercase k 


108 
109 
110 
111 


6C 
6D 
6E 
6F 


154 
155 
156 
157 


1 

m 

n 




Lowercase 1 
Lowercase m 
Lowercase n 
Lowercase o 
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Table F-l. ASCII Character Set (Continued) 



Decimal 
Code 


Hexadecimal 
Code 


Octal 
Code 


Graphic or 
Mnemonic 


Name or Meaning 


112 
113 
114 
115 


70 
71 
72 
73 


160 
161 
162 
163 


P 

q 

r 
s 


Lowercase p 
Lowercase q 
Lowercase r 
Lowercase s 


116 
117 
118 
119 


74 
75 
76 
77 


164 
165 
166 

167 


t 
u 

V 

w 


Lowercase t 
Lowercase u 
Lowercase v 
Lowercase w 


120 
121 
122 
123 


78 
79 
7A 
7B 


170 
171 
172 
173 


X 

y 

z 

{ 


Lowercase x 
Lowercase y 
Lowercase z 
Opening brace 


124 
125 
126 
127 


7C 
7D 

7E 
7F 


174 
175 
176 
177 


1 

} 

DEL 


Vertical line 
Closing brace 
Tilde 
Delete 
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This appendix lists the DI reset codes numerically and suggests actions based on them. 
Table G-l provides the numerical list of reset codes. The Action Code column in table 
G-l is keyed to the suggested actions, which follow the table. 

Table G-l. Numerical list of DI Reset Codes 



Numeric 
Code 



Reason Code 



00(16) power _up_reset 

02(16) manual _reset 

03(16) halt_memory_fault 

04(16) dead _man _time _out 

05(16) pp ..channel _master_clear 

06(16) reset .Junction 

10(16) load_software_too_big 

11(16) improper _first_module 

12(16) unsatisfied _external 

13(16) sysconfig_not_loaded 

14(16) post .load .routines .not .found 

15(16) reset _at_end_of_quiesce 

16(16) unrecognizable _object_text 

17(1 6) duplicate _entry _point 

18(16) task _error _no _recovery _proc 

19(16) task_error_exceed_max_recovers -■■ 

la(l 6) task_error_unrecoverable 

lb(16) no .configuration _file_obtained 

lc(16) configuration _file_read_error 

ld(16) not _enough _memory _for _buffers 

le(16) identification _record_expected 

lf(16) unexpected _idr_encountered 

20(16) premature _eof .on .file 

21(16) absolute _length_too_large 

22(16) invalid .object _text _version 

23(16) invalid .module _kind 

24(16) invalid _module .attribute 

25(16) invalid .section .ordinal 

26(16) duplicate .section 

27(16) invalid .section .kind 

28(16) invalid .allocation .alignment 

29(16) invalid .offset 

2a(16) storage .allocation .failed 

2b(16) undefined .section 

2c(16) reference .outside .of .section 

2d(16) invalid .address .kind 

2e(16) invalid .number _of .bytes .spanned 

2f(16) transfer _sym_entry.pt .not .found 

30(16) parameter .verification .error 

31(16) loader .table .not .found 



Issuing Component 



Action 
Code 



MPB ROM DA 

MPB ROM DA 

MPB ROM HW 

MPB ROM SW 

ICA Boot DA 

ICA Boot DA 
Initialization Bootstrap LF 
Initialization Bootstrap LF 

Initial "Loader LF 

Initial Loader LF 

Initial Loader LF 
Initialization Bootstrap DA 

Initial Loader LF 

Initial Loader LF 

System Ancestor SW 

System Ancestor SW 

System Ancestor SW 
Configuration Procurer OP 
Configuration Procurer OP 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader OP/LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 

Loader LF 
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Table G-l. 


Numerical List of DI Reset Codes (Continued) 




Numeric 






Action 


Code 


Reason Code 


Issuing Component 


Code 


32(16) 


kill _system .with _dump 


KILS Command 


DA 


33(16) 


kill _system _without .dump 


KILS Command 


DA 


34(16) 


stop_executive 


Executive 


SW 


35(16) 


module .checksum _is _invalid 


System Audits 


LF 


36(16) 


software _dead _stop 


DEAD STOP 


SW 


37(16) 


fatal _parity _error 


Executive 


HW 


38(16) 


ac .low .error 


Executive 


OP 


39(16) 


temperature .shutdown _error 


Executive 


OP 


3A(16) 


reset .from _debugger 


Hardwired in Debugger 


DA 


3B(16) 


overflowed _stack 


Exec/System Audits 


SW 


3C(16) 


system _data _not _found 


Initial Loader 


LF 


3D(16) 


boot _file _media .mismatch 


Boot Start-up Code 


OP/LF 


3E(16) 


cybil .detected _error 


CYBIL Routines 


SW 


3F(16) 


hard .failure 


Executive 


HW/SW 


40(16) 


well .known .configuration .change 


Configuration Procurer 


NA 


41(16) 


mpb _ram _ptr .not .found 


Initial Loader 


LF 


42(16) 


timer .task .module .missing 


Initial Loader 


LF 


43(16) 


task .received .unknown _itm 


Any Task 


SW 


44(16) 


sna-3270 .tip _dhcf .abort 


SNA 3270 TIP.DHCF 


SW 


45(16) 


configuration _cmd .read .error 


Configuration Procurer 


OP 


46(16) 


eeprom .updated 


Configuration Procurer 


NA 


47(16) 


loader .bus .error 


Initial Loader 


LF 



Suggested Actions Based on DI Reset Codes 

The remainder of this appendix describes the circumstances in which DIs reset and 
suggests actions to be taken based on various DI reset codes. This information is keyed 
to the Action Code column in table G-l through the abbreviation given for each reset 
title. Reset code descriptions are organized numerically within the action code groups. 

Some of the actions suggested here require tools or facilities that might not be 
available at your site. If you need further assistance, submit a programming system 
report (PSR) to Control Data. 

Deliberate Action (DA) 

These resets are due to human intervention. For resets that generate dumps, the 
following steps can be taken to obtain more information: 

• Display the executive error table with the Dump Analyzer DISEET subcommand. 

• Use the DISSCT subcommand to check for memory and/or buffer regulation. 

• Display calls for the running task. 

• Use the DISC subcommand to find any task calling DEAD.STOP, RESET.DI, or 
ABORT.SYSTEM. 
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Following are descriptions of the causes and suggested actions for the DI resets 
classified as deliberate actions: 

00(16) = POWER _UP_RESET 

No dump file is written under this condition. 

02(16) = MANUAL .RESET 

The toggle switch on the MPB was manually reset. Additional information 
should be obtained from the person who reset the system. 

05(16) = PP.CHANNEL .MASTER .CLEAR 

The ICA-II is reset during the host deadstart. 
06(16) = RESET.FUNCTION 

The ICA-II is reset via a reset function from the PP. 

15(16) = RESET.AT.END.OF.QUIESCE 

This occurs if a DI is manually reset while the onboard diagnostics are running, 
or if there was a channel error. If the host error log indicates a channel error, 
follow the hardware error reporting process. 

32(16) = KILL .SYSTEM .WITH .DUMP 

The system was reset by the KILL_SYSTEM operator command. Additional 
information should be obtained from the person who reset the system. 

33(16) = KILL .SYSTEM .WITHOUT.DUMP 

The system was reset by the KILL_SYSTEM operator command. Additional 
information should be obtained from the person who reset the system. No dump 
file is written under this condition. 

3A(16) = RESET.FROM .DEBUGGER 

The RS command was entered from the DI Resident Debugger. Additional 
information should be obtained from the person who reset the system. 
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No Action (NA) 

This type of reset does not require any human intervention. 

40(16) = WELL .KNOWN .CONFIGURATION .CHANGE 

The system was reset to immediately and automatically force the changes 
specified in the configuration file for the MPB RAM. 

There are a number of configurable values (such as which protocol stacks are 
enabled and data buffer size) that are associated with this reset. In addition, if 
a change in configuration affects the allocation of PMM, reset 40 is invoked. In 
any case, a dump is never taken when a reset 40 occurs. 

46(16) = EEPROM .UPDATED 

The system was reset to immediately and automatically force the changes first 
installed on the MPB-II board and/or one or more SMM4 boards in the DI. A 
dump is never taken when a reset 46 occurs. 

Operational (OP) 

The probable cause for each of these resets is something that can most likely be 
corrected on-site in the software or environmental conditions. The following suggested 
actions should be taken. 

1B(16) = NO_CONFIGURATION_FILE .OBTAINED 

Verify proper DI SYSTEM _ID at location 8400(16) by putting the DI in 
maintenance mode and using the DI console (see the CDCNET Hardware 
Installation and Troubleshooting manual). If your network is operating under 
NOS/VE, issue the ACTIVATE .NETWORK _FILE .ACCESS command. If there 
is no configuration file for the CDCNET system (or if it is busy or otherwise 
unavailable), an error is reported on the NOS/VE system job log display. Also, 
inspect the OCU library for a configuration file with the appropriate system 
identifier. 

Under NOS, verify that NETFS is running properly by examining the NAM 
K-display. Also, use NETFM to list or attach the configuration file (using the 
NF parameter). 

If no configuration file exists, create one. See the CDCNET Configuration Guide. 

The CDCNET log message 20 = CFP.FILE .OPEN .ERROR also indicates that 
the configuration file could not be opened. The Configuration File Procurer tries 
three times to open the file (with a delay between tries). You can enter the 
BYPASS .CONFIGURATION (BYPC) command and enter the configuration 
commands manually. If the file is not accessible after three tries and no 
BYPASS .CONFIGURATION command has been received, the DI is reset. 
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1C(16) - CONFIGURATION .FILE .READ.ERROR 

A configuration file read error occurred or the host file server became 
unavailable. Check the configuration file and check the status of the file server. 
If your network is operating under NOS/VE, examine the system job log display 
to determine if Network File Access restarted or terminated abnormally. 

Under NOS, verify that NETFS is running properly by examining the NAM 
K-display. 

The error may be due to using DIDEBUG while executing the configuration file 
commands, causing a loss of the logical link. 

2A(16) = STORAGE .ALLOCATION .FAILED 

This indicates that not enough memory was available when the Initial Loader 
was building the loader data structures for a module. Add more memory or 
remove modules from the boot file before reloading. This reset code is also listed 
under Load File (LF) action. 

38(16) = AC.LOW.ERROR, 

39(16) = TEMPERATURE .SHUTDOWN .ERROR . 

Environmental problems are suspect. Contact installation management personnel 
or customer engineers. 

3D(16) = BOOT.FILE .MEDIA .MISMATCH 

The boot file type loaded in the DI did not match the medium it was loaded 
across; for example, a channel boot file was loaded over ESCI instead of a 
channel. Look at field boot _map .entry .address in MPB RAM to find out what 
medium the DI was loaded across. See also this reset under the Load File (LF) 
heading. 

41(16) = MPB.RAM.PTR.NOT.FOUND 

The system MPB_RAM_PTR entry point (in EXEC.MPB or ICA.EXEC.MPB) 
is missing from the boot file. Rebuild the boot file, adding this module, before 
reloading. 

42(16) = TIMER .TASK .MODULE 

The TIMER .TASK .MODULE (EXEC.PMM or ICA.EXEC.MPB) is missing 
from the boot file. Rebuild the boot file, adding this module, before loading. 
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46(16) = CONFIGURATION _CMD_READ_ERROR 

A configuration command read error occurred or the host file server became 
unavailable while a configuration file command was executing. Check the 
configuration file and check the status of the file server. Additionally, the log 
messages in the dump file should show which command this error occurred on. 
If your network is operating under NOS/VE, examine the system job log display 
to determine if Network File Access restarted or terminated normally. 

Under NOS, verify that NETFS is running properly by examining the NAM 
K-display. 

The error may be due to using DIDEBUG while executing the configuration file 
commands, causing a loss of logical link. 

Load File (LF) 

The probable cause for each of these resets is a bad load file. If the load file has never 
been used successfully before, get a correct file. If this load file has been used 
successfully before, a software or hardware problem is likely. The following descriptions 
assume the latter to be true. 

10(16) = LOAD_SOFTWARE_TOO_BIG 

The boot file is too large to fit into SMM. Remove unnecessary modules from 
the boot file library or add more SMM before reloading. 

This reset may also indicate that the on-board diagnostics detected an SMM 
failure and have marked a block of SMM as unavailable. The remaining SMM is 
not sufficient for loading the boot file. 

11(16) = IMPROPER _FIRST_MODULE 

The first module in the boot file was not the Initial Loader (INITLDRABS). 
Check the boot file for irregularities, or to see if the library file might have 
been moved into a boot file by mistake. 

12(16) = UNSATISFIED_EXTERNAL 

The initial load failed because an entry point was referenced that was not 
externally declared by any module in the boot file. Missing entry point names 
are displayed on the DI console. Do a test link (using SES procedure) of the 
boot file object library after deleting any ABS modules. 

13(16) = SYSCONFIG_NOT_LOADED 

The SYS_CNFG table (in EXEC_MPB) is missing from the boot file. 
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14(16) = POST_LOAD ..ROUTINES .NOT.FOUND 

The entry INITIALIZE .EXECUTIVE (in POST.LOADER .PROCESSING) is 
missing from the boot file. 

16(16) = UNRECOGNIZABLE _OBJECT_TEXT, 

1E(16) = IDENTIFICATION .RECORD EXPECTED, 

1F(16) = UNEXPECTED _IDR .ENCOUNTERED, 

20(16) = PREMATURE EOF ON FILE, 

21(16) = ABSOLUTE .LENGTH .TOO LARGE, 

22(16) = INVALID .OBJECT.TEXT VERSION, 

23(16) = INVALID .MODULE .KIND, 

24(16) = INVALID .MODULE ATTRIBUTE, 

25(16) = INVALID .SECTION ORDINAL, 

26(16) = DUPLICATE .SECTION, 

27(16) = INVALID .SECTION KIND, 

28(16) = INVALID .ALLOCATION ALIGNMENT, 

29(16) = INVALID .OFFSET, 

2B(16) = UNDEFINED .SECTION, 

2C(16) = REFERENCE .OUTSIDE OF SECTION, 

2D(16) = INVALID .ADDRESS KIND," 

2E(16) = INVALID .NUMBER .OF BYTES SPANNED, 

2F(16) = TRANSFER _SYM _ENTRY_PT„NOT_FOUND 

Unknown or unsupported loader text records were found in the boot file or 
loader library. Check the file module library for irregularities. Check whether 
newly added modules were compiled with DIDEBUG on or by the wrong 
compiler or assembler. 

17(16) = DUPLICATE .ENTRY.POINT 

A duplicate entry point was detected. Do a test link (using SES procedure) of 
the boot file module library after deleting any ABS modules. 

1D(16) = NOT.ENOUGH_MEMORY.FOR .BUFFERS 

There must be enough memory after the initial load for allocation of 100 
descriptor buffers and 65535 bytes of data buffers. If not, this reset code is 
issued. Remove unnecessary modules from boot file library before reloading. 

2A(16) = STORAGE .ALLOCATION .FAILED 

This indicates that not enough memory was available when the Initial Loader 
was building the loader data structures for a module. Add more memory or 
remove modules from the boot file before reloading. This reset code is also listed 
under Operational (OP) action. 
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30(16) = PARAMETER .VERIFICATION JERROR 

A compilation-time error was detected: the named procedure XDCL and XREF 
parameters don't match either in type or number. Types must match exactly; 
they may not match by synonyms or aliases. Assembler entry points must 
precede CYBIL references when the CYBIL references do not agree. 

31(16) = LOADER .TABLE _NOT_FOUND 

A crucial loader data structure was not found. This structure is in module 
OLL .PROGRAM .INTERFACE _PROCS. Under NOS/VE, use the DISPLAY. 
OBJECTJLIBRARY command to examine the boot file. 

Under NOS, do a test link (using the SES.LINK68K procedure) on the object 
file to determine whether this module is in the boot file. 

If the module is missing, add it before reloading. 

35(16) = MODULE .CHECKSUM .IS .INVALID 

SYSTEM .AUDITS aborted the system because a loaded module was corrupted. 
Use the Dump Analyzer to examine the SYSTEM .AUDITS stack for the module 
name and section ordinal, then use DISM to examine the affected memory for 
recognizable patterns. To locate the SYSTEM .AUDITS stack: 

• Use DISTCB, with TI=ALL. 

• Examine the output for task name SYSTEM .AUDITS. 



• 



Display stack length number of bytes from the stack segment address in the 
SYSTEM .AUDITS TCB. This is the SYSTEM .AUDITS stack. 



3C(16) = SYSTEM .DATA .NOT .FOUND 

The SYSTEM .DATA entry point (in SYSTEM .AUDITS) is missing from the 
boot file. Rebuild the boot file, adding this module before reloading. 

3D(16) = BOOT.FILE .MEDIA .MISMATCH 

The boot file type loaded in the DI did not match the medium it was loaded 
across; for example, a channel boot file was loaded over ESCI instead of a 
channel. Look at field boot .map .entry .address in MPB RAM to find out what 
medium the DI was loaded across. Look at the XDCL'ed variable abort .message 
to see what the boot file type is. 

47(16) - LOADER .BUS .ERROR 

A bus error occurred during the initial load sequence. If any SMM errors 
occurred while leaving on-board diagnostics, the fault LED remains lit on the 
respective board(s). 
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Hardware (HW) 

A hardware problem is the probable cause for each of these resets. Perform the 
suggested hardware problem isolation or correction. 

03(16) = HALT_MEMORY_FAULT 

A double-bit SMM error occurred. Check NPA reports to identify failing SMM 
board. 

Board failure might show on indicator light if onboard diagnostics failed; this is 
seen after the DI resets and is going through diagnostics. See the CDCNET 
Hardware Installation and Troubleshooting manual. 

37(16) = SMM .DOUBLE _BIT_ERROR 

A double-bit SMM error occurred. Try the reset or power-on diagnostics to 
isolate the failing SMM board. See the CDCNET Hardware Installation and 
Troubleshooting manual. 

3F(16) = HARD_FAILURE 

This reset code is part of CDCNET's failure management feature. A hard failure 
is defined as one from which recovery is not possible; it can be caused by 
hardware or software. 

In the error log file, this message indicates the board slot number for the DI 
subsystem where the failure occurred. A separate log message is issued for the 
failing subsystem or its failed software. Examine the executive error table for 
clues. 

Software (SW) 

A software bug is the probable cause for each of these resets. Submit a PSR with the 
dump file and CDCNET log file. 

04(16) = DEAD_MAN_TIME_OUT 

A running task took too long to execute, preventing SYSTEM _AUDITS from 
resetting the timer. 

Use the Dump Analyzer to determine why the task timed out: 

1. Use the DISTCB subcommand to identify the task with the task state 
RUNNING— this is the task that timed out. 

2. Use the DISSCT subcommand to look at the following values: 

INTERRUPT FIREWALL CHAIN ADDRESS. This identifies the interrupt 
processor. 

BINARY TIME-OF-DAY. This indicates the millisecond clock value at the 
time of failure. 
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3. Use the DISM subcommand to look at the LAST_DEADMAN_RESET value 
in the system data record. 

If the difference between the binary time-of-day and LAST_DEADMAN _RESET 
is less than 10,000(10) and the interrupt firewall chain address was 0, then the 
error is probably hardware-related. Try to isolate the problem using the 
CDCNET Hardware Installation and Troubleshooting manual before writing a 
PSR. 

18(16) = TASK .ERROR .NO .RECOVERY PROC, 
19(16) = TASK .ERROR .EXCEED .MAX RECOVERS, 
1A(16) = TASK _ERROR .UNRECOVERABLE, 
36(16) = SOFTWARE .DEAD .STOP 

The task that caused the reset has a task state of RUNNING or SUSPEND. 

34(16) = STOP.EXECUTIVE 

Use the Dump Analyzer DISEET or DISM subcommands to examine the 
executive error table for error information. The field STOP_SUPERVISOR_ 
STACK .POINTER contains the supervisor stack pointer at the time of the 
reset. Using DISM, display this stack. The top of the stack contains the return 
address to the caller of STOP_EXEC. 

3B(16) = OVERFLOWED _STACK 

A stack overflow was detected on a call to the Executive when the value of 
register A7 was numerically less than the first byte address of the stack, or by 
SYSTEM .AUDITS after a task had stopped. Use the VALSA subcommand to 
reveal violations of stack areas. Or, use DISC to check the affected task for 
recursive calling. Move large variables off the stack or increase the stack size. 
Use ALLOCATE/FREE rather than PUSH CYBIL statements, if feasible. 

3E(16) = CYBIL .DETECTED .ERROR 

CYBIL run-time routines detected an error (when compiled with range checking 
on). Correct code and rebuild the boot file before reloading. 

3F(16) = HARD .FAILURE 

This reset code is part of CDCNET's failure management feature. A hard failure 
is defined as one from which recovery is not possible; it can be caused by 
hardware or software. See the description of this reset code under the Hardware 
(HW) heading. 

43(16) = TASK .RECEIVED .UNKNOWN _ITM 

This reset code indicates that an unknown ITM task message was received by a 
task. 

44(16) = SNA .3270 .TIP.DHCF.ABORT 

This reset code occurs when the TIP software traps an invalid request response 
unit. 
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** Command (NOS Only) 2-29 

ACTIVATE .ALARMS (ACTA) 2-2 

ADD_ARP_REPORTED_NETS (ADDARN) 3-2 

ADD_CLNS_FILTER (ADDCF) 3 . 2 2 

ADD_CONS_INCALL (ADDCI) ' " 3I4 

ADD_CONS_OUTCALL (ADDCO) 3-4 2 

ADD_CONS_1980_X25 .MAPPING (ADDClXM) ..[ 3.47 

ADD_EGP_REPORTED_NETS (ADDERN) 3-8 

ADD_INCOMING_SERVICE .ACCESS (ADDISA) 3.10 

ADD_IP_FILTER (ADDIF) 3-12 1 

ADD_NON _CDC .ADDRESS .PREFIX (ADDNCAP) 3-13 

ADD.NON _CDC .ROUTING .ENTRY (ADDNCRE) 3-15 

ADD.NP.GW.OUTCALL (ADDNGO) (NOS only) 3-18 

ADD.OUTGOING .SERVICE ACCESS (ADDOSA) 3-19 

ADD.RIP.SERVICE (ADDRS) 3-22 

ADD.SNMP.COMMUNITY (ADDSC) 3-22 3 

ADD.TCPIP.ACCESS (ADDTA) (NOS/VE Only) "..[ 3-22 5 

ADD.TELNET.SERVER (ADDTS) 3-25 

ADD.X25.GW.INCALL (ADDXGI) 3-28 

ADD.X25 .GW.OUTCALL (ADDXGO) 3-30 

ADD.X25_GW.PVC (ADDXGP) 3.32 l 

ADD.X25.INCALL (ADDXI) 3.32 3 

ADD.X25 .SWITCH (ADDXS) " ' 3.326 

ADD_X25_TERMINAL_GW_OUTCALL (ADDXTGO) 3.33 

ANALYZE .CDCNET.DUMP (ANACD) 19-2 

ARCHIVE _NPA_DATA_BASE (ARCNDB) 18-3 

ATTCF (Attach Configuration File) (NOS MDI Only) 17-8 

CANCEL.CHANNEL.TRUNK (CANCT) (NOS MDI Only) 4-2 

CANCEL .DEVICE .OUTCALL .SERVICE (CANDOS) 4-3 

CANCEL.EGP.PEER (CANEP) 4.4 

CANCEL_ETHER.NET (CANEN) 4.5 

CANCEL.ETHER.TRUNK (CANET) 4-6 

CANCEL .FILE .SUPPORT (CANFS) (NOS MDI Only) 4-7 

CANCEL_HDLC.NET (CANHN) 4.8 

CANCEL.HDLC .TRUNK (CANHT) 4.9 

CANCEL.IP.HOST (CANIH) 4-10 

CANCEL_IP_NET (CANIN) " " 4-11 

CANCEL.IP_X25.PDN .HOST (CANIXPH) 4-12 

CANCEL.LINE (CANL) 4-12 1 

CANCEL .NAME .RESOLVER (CANNR) 4-13 

CANCEL_NP_INTERFACE (CANNI) (NOS MDI Only) 4-14 

CANCEL.NP_TERMINAL.GW (CANNTG) 4-15 

CANCEL.OPERATOR.SUPPORT (CANOS) (NOS MDI Only) 4-16 

CANCEL_OUTCALL_GATEWAY (CANOG) 4-17 

CANCEL _PASSTHROUGH .SERVICE (CANPS) " ' 4-18 

CANCEL.RECORDER.LOG.GROUP (CANRLG) (NOS MDI Only) 4-19 

CANCEL .REMOTE .LINE .MONITOR (CANRLM) 4-20 

CANCEL .REMOTE .LOAD.SUPPORT (CANRLS) 4-21 

CANCEL .SERVER _TELNET_GW (CANSTG) 4-22 

CANCEL .SLIP.GW (CANSG) 4.22 1 

CANCEL_SLIP_HOST (CANSH) ' ' 4.222 

CANCEL_SNMP_AGENT (CANSA) * 4.23 

CANCEL_SOURCE_ALARM_GROUP (CANSAG) 4-25 
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CANCELJ30URCE .ALARM .MESSAGE (CANSAM) 4-26 

CANCEL .SOURCE _LOG_GROUP (CANSLG) 4-27 

CANCEL_TCPIP_GW (CANTG) 4-28 

CANCEL_UDP_INTERFACE (CANUI) 4-29 

CANCEL _USER_TELNET_GW (CANUTG) 4-30 

CANCEL _USER .VALIDATION (CANUV) 4-31 

CANCEL_X25_ASYNCTTP (CANXA) 4-32 

CANCEL_X25_GW (CANXG) 4.33 

CANCEL _X25 .INTERFACE (CANXI) 4.34 

CANCEL_X25.NET (CANXN) 4.35 

CANCEL.X25_TERMINAL.GW (CANXTG) 4-36 

CANCEL _X25 .TRUNK (CANXT) 4.37 

CHANGE .ALARM .ENVIRONMENT (CHAAE) (NOS Only) 2-3 

CHANGE _CDCNET_ADDRESS .PREFIX (CHACAP) 5-2 

CHANGE .CHANNEL .TRUNK (CHACT) (NOS MDI Only) 5-5 

CHANGE.CLNS (CHAC) 5-6 

CHANGE .DIRECTORY (CHAD) 5-61 

CHANGE .ELEMENT.STATE (CHAES) 5-7 

CHANGE _ESIS_ROUTING_OPTIONS (CHAERO) 5-9 

CHANGE _EXPECTED_OPERATING_LIMIT (CHAEOL) 18-6 

CHANGE _NAME_RESOLVER (CHANR) 5-12 1 

CHANGE _OSI .TRANSPORT (CHAOT) 5-13 

CHANGE .OUTCALL .GATEWAY (CHAOG) 5-16 

CHANGE .PASSTHROUGH .SERVICE (CHAPS) 5-17 

CHANGE .PRINTER .MODEL .ATTRIBUTES (CHAPMA) 5-18 

CHANGE .SERVER _TELNET_GW (CHASTG) 5-23 

CHANGE .SERVICE .DISPLAY (CHASD) 5-25 

CHANGE .SERVICE .DISPLAY.TEXT (CHASDT) 5-27 

CHANGE _SNMP_AGENT (CHASA) 5-28 1 

CHANGE .SOURCE JLOG.GROUP (CHASLG) 5-29 

CHANGE.SYSTEM (CHAS) 5-30 

CHANGE .TCP.INTERFACE (CHATI) 5.34 

CHANGE .TELNET.SERVER (CHATS) 5-37 

CHANGE .TELNET.SERVICE .NAME (CHATSN) 5-38 1 

CHANGE .USER .TELNET.GW (CHAUTG) 5-39 

CREATE .CDCNET.ANALYSIS .REPORT (CRECAR) 18-8 

DEACTIVATE .ALARMS (DEAA) 2-4 

DEFCF (Define Configuration File) (NOS MDI Only) 17-10 

DEFINE .ACCESSIBLE .REMOTE .SYSTEM (DEFARS) 15-2 

DEFINE .BATCH .DEVICE (DEFBD) 15-4 

DEFINE .BATCH .STREAM (DEFBS) [ . 15-18 

DEFINE _BOOT_DEFAULTS (DEFBD) 6-2 

DEFINE .CHANNEL .TRUNK (DEFCT) 6-3 

DEFINE .CODE _SET_BASE (DEFCSB) 16-2 

DEFINE .CODE .SET.TRANSLATION (DEFCST) 16-3 

DEFINE .DEVICE .OUTCALL .SERVICE (DEFDOS) (NOS/VE Only) 6-5 

DEFINE .EGP.PEER (DEFEP) 6-6 

DEFINE_ETHER.NET (DEFEN) 6-10 

DEFINE .ETHER _TRUNK (DEFET) ' 6-17 

DEFINE _EXCEPTION .SYSTEM (DEFES) 6-19 

DEFINE _FILE .SUPPORT (DEFFS) (NOS Only) 6-21 

DEFINE _HDLC_NET (DEFHN) 6-23 

DEFINE _HDLC .TRUNK (DEFHT) 6-30 

DEFINE .I.O.STATION (DEFIOS) 15-21 

DEFINE_INETD 6-37 

DEFINE _IP_HOST (DEFIH) 6-38 
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DEFINE_IP_NET (DEFIN) 6-42 

DEFINE _IP_X25_PDN_HOST (DEFIXPH) 6-46 

DEFINE _LINE (DEFL) "6-46 3 

DEFINE _LLC_2_TRUNK (DEFL2T) 6-55 

DEFINE _NAME_RESOLVER (DEFNR) 6-58 

DEFINE _NP_BATCH .STATION (DEFNBS) (NOS Only) " ' 15-25 

DEFINE _NP_GW (DEFNG) (NOS Only) 6-60 

DEFINE _NP_INTERFACE (DEFNI) (NOS Only) 6-63 

DEFINE _NP_TERMINAL_GW (DEFNTG) (NOS Only) 6-65 

DEFINE .OPERATOR .SUPPORT (DEFOS) (NOS Only) 6-69 

DEFINE _OUTCALL_GATEWAY (DEFOG) 6-70 

DEFINE _PASSTHROUGH .SERVICE (DEFPS) 6-71 

DEFINE .PRINTER .MODEL .ATTRIBUTES (DEFPMA) ... " 6-73 

DEFINE .RECORDER .LOG.GROUP (DEFRLG) (NOS Only) 6-80 

DEFINE .REMOTE .LINE .MONITOR (DEFRLM) 6-82 

DEFINE .REMOTE .LOAD.SUPPORT (DEFRLS) 6-83 

DEFINE .REMOTE .SYSTEM (DEFRS) 15-26 

DEFINE .SERVER .DEVICE (DEFSD) " 6-85 

DEFINE .SERVER .TELNET.GW (DEFSTG) 6-88 

DEFINE .SERVICE (DEFS) ... ^ ^ 

DEFINE .SLIP.GW (DEFSG) " 6 -94 

DEFINE .SLIP.HOST (DEFSH) " " 6 -94 3 

DEFINE .SNMP.AGENT (DEFSA) 6-94 5 

DEFINE .SOURCE .ALARM .MESSAGE (DEFSAM) " 6-95 

DEFINE .SOURCE .LOG.GROUP (DEFSLG) 6-97 

DEFINE.SYSTEM (DEFS) 6-98 

DEFINE .TCP.INTERFACE (DEFTI) 6-103 

DEFINE .TCPIP.GW (DEFTG) (NOS Only) " 6-107 

DEFINE .TERMINAL .DEVICE (DEFTD) " " 15.31 

DEFINE .TIP (DEFT) 6-109 

DEFINE .UDP.INTERFACE (DEFUI) 6-114 

DEFINE _USER_I.O_STATION (DEFUIOS) 15-35 

DEFINE .USER .TELNET.GW (DEFUTG) '6-116 

DEFINE .USER .VALIDATION (DEFUV) " 6-119 

DEFINE _VE .INTERFACE (DEFVI) 6-120 

DEFINE .VFU.LOAD.IMAGE (DEFVLI) 16-4 

DEFINE _X25 .ASYNCTIP (DEFXA) " "6-123 

DEFINE.X25.GW (DEFXG) 6-127 

DEFINE _X25 .INTERFACE (DEFXI) " 6 -130 

DEFINE_X25.NET (DEFXN) * * 6 -135 

DEFINE _X25 .TERMINAL _GW (DEFXTG) " 6-140 

DEFINE _X25 .TRUNK (DEFXT) " " 6-142 

DELETE _ARP JREPORTED.NETS (DELARN) 7-2 

DELETE _CLNS .FILTER (DELCF) 7-2 l 

DELETE .CONS .INCALL (DELCI) 7-2*3 

DELETE .CONS .OUTCALL (DELCO) 7-2 5 

DELETE .CONS .1980 _X25 .MAPPING (DELC1XM) 7.3 

DELETE _EGP_REPORTED.NET (DELERN) 7-5 

DELETE .INCOMING.SERVICE .ACCESS (DELISA) ' ' 7-6 

DELETE .IP.FILTER (DELIF) 7.6 1 

DELETE _NON_CDC .ADDRESS .PREFIX (DELNCAP) 7I7 

DELETE _NON _CDC _ROUTING_ENTRY (DELNCRE) ... 7-9 

DELETE .OUTGOING .SERVICE .ACCESS (DELOSA) ... 7-H 

DELETE _RIP_SERVICE (DELRS) 7-12 

DELETE _SNMP_COMMUNITY (DELSC) 7-12 1 

DELETE _TCPIP_ACCESS (DELTA) 7.12*2 
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DELETE .TELNET.SERVER (DELTS) 7-13 

DELETE _X25 _GW_INCALL (DELXGI) 7-14 

DELETE _X25 _GW_OUTCALL (DELXGO) 7-15 

DELETE _X25_GW_PVC (DELXGP) 7-16 

DELETE _X25_INCALL (DELXI) 7-16 1 

DELETE _X25 .SWITCH (DELXS) ' 7-18 

DELETE _X25 .TERMINAL _GW_OUTCALLS (DELXTGO) 7-21 

DISPLAY_ALARM .ENVIRONMENT (DISAE) (NOS Only) 2-5 

DISPLAY_ALARM .HISTORY (DISAH) (NOS Only) 2-6 

DISPLAY_AUTO_DUMP_TABLE (DISADT) 19-10 

DISPLAY_BOARD_MAP_TABLE (DISBMT) 19-12 

DISPLAYJBUFFER.CHAIN (DISBC) 19-14 

DISPLAY.CALLS (DISC) 19-17 

DISPLAY_CATENET_TITLES (DISCT) (NOS Only) " 2-7 

DISPLAY_CHANNEL_CONNECT_STATUS (DISCOS) 8-2 

DISPLAY.CLNS .FILTER (DISCF) 8-41 

DISPLAY.CLNS.OPTIONS (DISCO) 8-5 

DISPLAY.COMMAND.INFORMATION (DISCI) (NOS Only) 2-9 

DISPLAY.COMMAND.INFORMATION (DISCI) 8-6 19-20 

DISPLAY.COMMAND.LIST (DISCL) 2-11, 8-7' 19-21 

DISPLAY_COMMAND_LIST_ENTRY (DISCLE) ' 2-13 8-8 

DISPLAY_CONNECTED_MDI (DISCM) (NOS Only) 2-14 

DISPLAY.CONS.INCALL (DISCIC) 8-81 

DISPLAY_CONS_OUTCALL (DISCOC) 8-8 3 

DISPLAY_CONS_1980_X25 .MAPPING (DISC1XM) 8-9 

DISPLAY.DATA .QUEUE (DISDQ) 19-24 

DISPLAY_DATE_AND_TIME (DISDAT) 8-10 

DISPLAY_DEVICE_OUTCALL_STATUS (DISDOS) 8-11 

DISPLAY_DIRECTORY_STATUS (DISDS) 8-12 

DISPLAY_DI .SYSTEM .STATUS (DISDSS) 8-16 19-27 

DISPLAY.EGP _PEER_STATUS (DISEPS) ' 8-20 

DISPLAY.ESIS .ROUTING .OPTIONS (DISERO) 8-24 1 

DISPLAY.ESIS .ROUTING .STATUS (DISERS) 8-24 2 

DISPLAY.ETHER.NET.OPTIONS (DISENO) 8-25 

DISPLAY.ETHER.TRUNK .OPTIONS (DISETO) 8-27 

DISPLAY.EXECUTIVE .ERROR .TABLE (DISEET) 19-30 

DISPLAY.FILE.LOAD.STATUS (DISFLS) 8-28 

DISPLAY.FILE .SUPPORT (DISFS) (NOS MDI Only) 8-29 

DISPLAY.HARDWARE .STATUS (DISHS) 8-30 19-33 

DISPLAY_HDLC_NET_OPTIONS (DISHNO) 8-35 

DISPLAY.HDLC .TRUNK .OPTIONS (DISHTO) 8-37 

DISPLAY.ICA .SYSTEM .STATUS (DISISS) 8-39 19-37 

DISPLAY.IPJPILTER (DISIF) ' 8-40 

DISPLAY.IP.STATUS (DISIS) 8-40 1 

DISPLAY.ISIS.ROUTING.STATUS (DISIRS) 8-44 

DISPLAY.LINE .CONTROL .BLOCK (DISLCB) 19-38 

DISPLAY.LINE .OPTIONS (DISLO) 8-48 

DISPLAY.LINE .STATUS (DISLS) 8-50 

DISPLAY.LINKED.LIST (DISLL) 19-40 

DISPLAY.LLC.2.STATUS (DISL2S) 8-56 

DISPLAY.LLC .2 .TRUNK .OPTIONS (DISL2TO) 8-58 

DISPLAY.LOGICAL .NAMES (DISLN) 8-60 

DISPLAY.LOG.QUEUES (DISLQ) 19-42 

DISPLAY.MEMORY (DISM) 8^61 19-46 

DISPLAY.MEMORY.HEADER (DISMH) ' 19-49 

DISPLAY.MEMORY.MAP (DISMM) 19-51 
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DISPLAY_MEMORY_USERS (DISMU) 19-54 

DISPLAY_NAME _RESOLVER .STATUS (DISNRS) 8-63 

DISPLAY_NET_DELAY .MEASUREMENT (DISNDM) 8-64 

DISPLAY_NETWORK .STATUS (DISNS) 8-65 19-58 

DISPLAY_NON _CDC .ADDRESS .PREFIX (DISNCAP) ' 8-70 

DISPLAY_NON_CDC_ROUTING_ENTRY (DISNCRE) 8-72 

DISPLAY_NP_GW_OPTIONS (DISNGO) 8-74 

DISPLAY.NP.INTERFACE .OPTIONS (DISNIO) 8-75 

DISPLAY.OPERATOR .SUPPORT (DISOS) (NOS MDI Only) 8-76 

DISPLAY.OSI .TRANSPORT.OPTIONS (DISOTO) 8-77 

DISPLAY.OSI.TRANSPORT.STATUS (DISOTS) 8-78 

DISPLAY_OUTCALL_GATEWAY_STATUS (DISOGS) 8-84 

DISPLAY.PASSTHROUGH .STATUS (DISPS) 8-85 

DISPLAY-RECORDER .LOG .GROUP (DISRLG) (NOS MDI Only) 8-87 

DISPLAY.REMOTE .LOAD.SUPPORT (DISRLS) 8-88 

DISPLAY.RIP.SERVICE (DISRS) 8-89 

DISPLAY.SERVICE .DISPLAY (DISSD) 8-91 

DISPLAY.SLIP.GW (DISSG) 8-93 

DISPLAY.SNMP.AGENT.OPTIONS (DISSAO) 8-94 

DISPLAY.SOFTWARE .LOAD.STATUS (DISSLS) 8-95 

DISPLAY-SOURCE ^ALARMS (DISSA) 8-96 

DISPLAY.SOURCE .LOG.GROUP (DISSLG) 8-97 

DISPLAY.SYSTEM .CONFIG .TABLE (DISSCT) 19-60 

DISPLAY.SYSTEM .OPTIONS (DISSO) 8-98 

DISPLAY.TASK .CONTROL .BLOCK (DISTCB) 19-63 

DISPLAY.TCP.INTERFACE .OPTIONS (DISTIO) 8-100 

DISPLAY.TCP.INTERFACE .STATUS (DISTIS) 8-101 

DISPLAY_TELNET_SERVER .STATUS (DISTSS) 8-102 

DISPLAY.TELNET.SERVICE .NAME (DISTSN) 8-102 1 

DISPLAY.TEST.STATUS (DISTS) 8-103 

DISPLAY.TREE (DIST) 19-66 

DISPLAY.TRACE .PROCESS (DISTP) 8-110 2 

DISPLAY.TRUNK .METRICS (DISTM) 8-112 

DISPLAY.USER .VALIDATION (DISUV) 8-115 

DISPLAY_X25.ASYNCTIP_OPTIONS (DISXAO) 8-116 

DISPLAY_X25_GW_INCALL_OPTIONS (DISXGIO) 8-118 

DISPLAY.X25 .GW.OPTIONS (DISXGO) 8-119 

DISPLAY.X25 .GW.OUTCALL .OPTIONS (DISXGOO) 8-120 

DISPLAY.X25 .GW.PVC .OPTIONS (DISXGPO) 8-120 1 

DISPLAY.X25.INCALL (DISXI) 8-120 2 

DISPLAY.X25 .INTERFACE .OPTIONS (DISXIO) 8-121 

DISPLAY.X25 .INTERFACE .STATUS (DISXIS) 8-123 

DISPLAY_X25_NET_OPTIONS (DISXNO) 8-125 

DISPLAY.X25 .SWITCH (DISXS) 8-127 

DISPLAY.X25 .TERMINAL _GW (DISXTG) 8-129 

DISPLAY.X25 .TERMINAL .GW.OUTCALL (DISXTGO) 8-130 

DISPLAY.X25 .TRUNK .OPTIONS (DISXTO) 8-131 

EDIT.CDCNET.LOG .MESSAGE (EDICLM) 18-16 

EXECUTE .COMMAND.FILE (EXECF) (NOS Only) 2-15 

EXECUTE .ECHO.TEST (EXEET) 9-2 

EXPLAIN .CDCNET.LOG.MESSAGE (EXPCLM) ' 18-17 

GETCP (Get CDCNET Procedure) (NOS MDI Only) 17-5 

GET.CDCNET.PROCEDURE (GETCP) (NOS/VE Only) 17-2 

HELP(HEL) " i9_ 68 

HELP (NOS Only) 2-17 

HELP 93 
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IDLE .SERVER .DEVICES (IDLSD) 9-4 

IDLE_TELNET_SERVER (IDLTS) 9-5 

INCLUDE _FILE (INCF) (NOS Only) 2-18 

KILL_SYSTEM (KILS) 9-6 

LOAD_FILE (LOAF) 10-2 

LOAD_MODULE (LOAM) 10-4 

PUT_BATCH .SEQUENCE (PUTBS) 16-7 

PUT_STRING (PUTS) 15-39 

QUIT (QUI) 2-20, 19-70 

REFORMAT_CDCNET_LOG .FILE (REFCLF) 18-18 

RELOAD.NPA_DATA.BASE (RELNDB) 18-36 

REPCF (Replace Configuration File) (NOS MDI Only) 17-12 

REPCP (Replace CDCNET Procedure) (NOS MDI Only) 17-7 

REPLACE _CDCNET_PROCEDURE (REPCP) (NOS/VE Only) 17-3 

RESTORE .ALARM .ENVIRONMENT (RESAE) (NOS Only) 2-21 

RESUME .SERVER .DEVICES (RESSD) 10-6 

RESUME .TELNET.SERVER (RESTS) 10-7 

ROUTE.ALARM (ROUA) (NOS Only) 2-22 

ROUTE .COMMAND.RESPONSE (ROUCR) (NOS Only) 2-23 

SELECT.TASK (SELT) 19-71 

SEND.COMMAND (SENC) 2-24 

SEND.COMMAND.SEQUENCE (SENCS) (NOS Only) 2-25 

SEND.DIAGNOSTIC.DATA (SENDD) 11-2 

SETVL (Set Version Level Procedure) (NOS MDI Only) 17-14 

SET.COMMAND.MDI (SETCM) (NOS Only) 2-27 

SET_DATE.AND.TIME (SETDAT) 11-5 

SET.PAD.MESSAGE (SETPM) 15-41 

SET.VERSION .LEVEL (SETVL) (NOS/VE Only) 17-4 

START.CIM.TEST (STACT) 12-2 

START.EGP.PEER (STAEP) 12-5 

START.ESCI.TEST (STAET) 12-6 

START_LIM_TEST (STALT) 12-8 

START.LINE (STAL) 12-11 

START.LINE .METRICS (STALM) 12-12 

START.MCI .INLINE .TEST (STAMIT) 12-14 

START.MCI.TEST (STAMT) 12-16 

START_NET_DELAY_MEASUREMENT (STANDM) 12-18 

START.NETWORK (STAN) 12-20 

START.NETWORK .METRICS (STANM) 12-21 

START _NP_INTERFACE (STANI) (NOS MDI Only) 12-23 

START.OUTCALL.GATEWAY (STAOG) 12-24 

START.PASSTHROUGH .SERVICE (STAPS) 12-25 

START.PORT.TEST (STAPT) 12-26 

START.PROCESS .METRICS (STAPM) 12-32 

START_SERVER_TELNET_GW (STASTG) 12-35 

START.SLIP.GW (STASG) 12-36 

START_SUBNET_CONNECT_TEST (STASCT) 12-37 

START.TCPIP.GW (STATG) 12-40.1 

START.TRACE .PROCESS (STATP) 12-40.2 

START.TRUNK (STAT) 12-41 

START.TRUNK .METRICS (STATM) 12-43 

START_UDP_INTERFACE (STAUI) 12-45 

START.URI.TEST (STAUT) 12-46 

START.USER_TELNET.GW (STAUTG) 12-49 

START_X25_ASYNCTIP (STAXA) 12-50 

START.X25.GW (STAXG) 12-51 
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STARTJC25JNTERFACE (STAXI) 12-52 

START_X25_TERMINAL_GW (STAXTG) 12-53 

STATUS Parameter 19.9 

STOP_CIM_TEST (STOCT) 13.2 

STOP_EGP_PEER (STOEP) " 13.3 

STOP_ESCI_TEXT (STOET) 13-4 

STOP_LIM_TEST (STOLT) ' 13-5 

STOP_LINE (STOL) 1 3 . 6 

STOP_LINE_METRICS (STOLM) "13.7 

STOP_MCI_INLINE_TEST (STOMIT) 13-8 

STOP_MCI_TEST (STOMT) 13.9 

STOP_NET_DELAY_MEASUREMENT(STONDM) 13-10 

STOP_NETWORK (STON) i3.ll 

STOP_NETWORKJVIETRICS (STONM) 13-12 

STOP_NP_GW (STONG) (NOS MDI Only) 13-13 

STOP_NP_INTERFACE (STONI) (NOS MDI Only) 13-14 

STOP_NP_TERMINAL_GW (STONTG) „ 13-15 

STOP_OUTCALL_GATEWAY (STOOG) 13-16 

STOP_PASSTHROUGH_SERVICE (STOPS) 13-17 

STOP_PORT_TEST (STOPT) 13.18 

STOP_PROCESS_METRICS (STOPM) „ 13-19 

STOP_SERVER_TELNET_GW (STOSTG) 13-21 

STOP_SLIP_GW (STOSG) 13-22 

STOP_SUBNET_CONNECT_TEST(STOSCT) 13-23 

STOP_TCPIP_GW (STOTG) 13-24 

STOP_TRACE_PROCESS (STOTP) 13-25 

STOP_TRUNK (STOT) 13-26 

STOP_TRUNK_METRICS (STOTM) 13-27 

STOPJJDPJNTERFACE (STOUI) 13-28 

STOP_URI_TEST (STOUT) 13-29 

STOP_USER_TELNET_GW (STOUTG) 13-30 

STOP_X25_ASYNCTIP (STOXA) 13.31 

STOP_X25_GW (STOXG) 13-32 

STOP_X25_INTERFACE (STOXI) 13.33 

STOP_X25_TERMINAL_GW (STOXTG) 13-34 

STOP_X25_VIRTUAL_CIRCUIT (STOXVC) 13-35 

SUBMIT BATCH JOB PERIODICALLY (SUBBJP) (NOS MDI Only) 18-39 

SYNCHRONIZE_CLOCK (SYNC) 14-2 

UNLOAD_FILE (UNLF) '14.3 

UNLOAD_MODULE (UNLMO ' "14.4 

VALIDATE_GLOBAL_INFORMATION(VALGI) " "l9-72 

VALIDATE_STACK W AREAS (VALSA) 19-74 

WAIT ZZZ.A5-46 

WRITE_TERMINAL_MESSAGE (WRITM) 14-5 
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